Problemas depois de atualizar.

Learn DXPR BuilderManage the siteEen probleem oplossen

Termine uma atualização que correu mal. Em quase todos os casos, o código foi atualizado mas a base de dados não, uma cópia restante do módulo está no caminho ou falta uma dependência.

Corra a atualização pela ordem certa

  1. Faça uma cópia de segurança da base de dados.
  2. Corra composer require drupal/dxpr_builder, com uma restrição de versão se fixar lançamentos.
  3. Corra drush updb -y (ou visite /update.php).
  4. Corra drush cr.
  5. Abra uma página do construtor e guarde-a de novo.

Importante: nunca desinstale o módulo para o atualizar. Desinstalar apaga modelos guardados, perfis e definições.

O Composer mostra um erro

  • "Could not find a version of package drupal/dxpr_builder matching your minimum-stability". O 3.x é publicado como lançamentos beta. Permita-os na restrição: composer require 'drupal/dxpr_builder:^3.0@beta'.
  • "Could not find a matching version of package dxpr/dxpr_builder". O pacote em drupal.org é drupal/dxpr_builder. Substitua dxpr/dxpr_builder por drupal/dxpr_builder em composer.json e depois corra composer update drupal/dxpr_builder.
  • O Composer recusa porque a pasta não é gerida pelo Composer. Uma cópia foi carregada à mão. Apague modules/contrib/dxpr_builder e corra de novo o comando require.
  • "Disk quota exceeded" ou "write failed". Liberte espaço em disco no servidor antes de tentar de novo.

A atualização da base de dados falha

  • "Unable to install modules key due to missing modules key". O 3.x precisa do módulo Key e a atualização 9020 instala-o. O seu código falta porque o módulo não foi instalado com o Composer. Corra composer require drupal/key e depois drush updb -y de novo.
  • Um update hook nomeado falha. Corra drush updb -vvv e inclua o erro completo no seu ticket.
  • "module 'dxpr_builder_page' is missing its dependency module field_group". O submódulo DXPR Builder Drag and Drop Page precisa de Field Group. Corra composer require drupal/field_group e depois drush en dxpr_builder_page -y.

As páginas ficam partidas depois da atualização

Alguns lançamentos convertem marcação antiga, como carrosséis Owl e contadores circulares, em lotes durante drush updb. Os itens que falham ficam pendentes.

  1. Vá a DXPR Studio > DXPR Builder > Content items > Migrations (/admin/dxpr_studio/dxpr_builder/migration-status).
  2. Se uma migração mostra Pending, clique em Run now ou em Run all pending migrations.
  3. Verifique Reports > Recent log messages para os itens que um lote saltou.

O Composer recusa uma atualização principal do núcleo Drupal

O DXPR Builder 3.x suporta Drupal 10.2 e posterior, e Drupal 11.

  1. Verifique as notas de lançamento do DXPR Builder, DXPR Theme e DXPR Theme Helper para a versão que suporta a nova principal.
  2. Corra Upgrade Status para ver que pacotes não estão prontos.
  3. Fixe a principal do núcleo em composer.json. Um composer require drupal/core-recommended sem restrição pode puxar a próxima principal por acidente.

O editor partiu-se logo depois da atualização

Siga O editor não aparece. As principais causas lá são as que seguem uma atualização parcial: atualizações pendentes da base de dados, ficheiros desatualizados e uma cache de agregação construída a partir do lançamento antigo.

Estou a migrar do Glazed Builder

O DXPR Builder 3.x já não converte nomes de classes Glazed no conteúdo guardado. Atualize primeiro para o último lançamento 2.x e corra as suas atualizações da base de dados, depois atualize para 3.x. Veja Migrar do DXPR Builder 1.x ou 2.x.

Confirmar a correção

drush updb não indica atualizações pendentes, drush pm:list --filter=dxpr mostra as versões pretendidas e uma página do construtor guardada de novo apresenta-se igual no editor e para um visitante.

E a seguir?

Atualizar o DXPR Builder para o procedimento de atualização de rotina.