Atualizar o DXPR Builder.

Aprender DXPR BuilderComece aquiInstalar e atualizar

Atualize o DXPR Builder para receber correções de erros, funcionalidades novas e correções de segurança. Atualiza o código com Composer e deixa o Drupal converter definições e conteúdo com drush updatedb. Use esta página para atualizações dentro da série 3.x. Vem de 1.x ou 2.x? Siga antes Migrar do DXPR Builder 1.x ou 2.x.

Antes de começar

Faça cópia de segurança da base de dados:

drush sql:dump > backup-$(date +%Y%m%d).sql

Leia o Registo de alterações e a página de versões GitHub para mudanças que exigem ação, como a passagem para Font Awesome 7 no DXPR Builder.
Experimente a atualização primeiro numa cópia de teste do site.

Atualizar o módulo

Atualize o código:

composer update drupal/dxpr_builder --with-dependencies

Corra as atualizações da base de dados. Também pode visitar /update.php:
```
drush updatedb
```
Algumas atualizações convertem cada valor de campo DXPR Builder em lotes. Em sites grandes demoram minutos, não segundos.
Reconstrua as caches, para que os navegadores recebam as novas folhas de estilo e scripts:
```
drush cache:rebuild
```

O que vê

Páginas com conteúdo DXPR Builder parecem como antes. Paire o cursor sobre uma como editor e as barras de controlos aparecem; faça uma pequena alteração e clique em Save para verificar que guardar funciona. General Settings continua a mostrar a sua chave de produto em License.

Página de definições gerais do DXPR Builder

Depois abra Reports > Status report (/admin/reports/status). Junto a DXPR Builder content migrations diz All migrations completed.

Se não vir a nova versão

O editor continua a comportar-se como a versão antiga. O navegador guarda os ficheiros antigos do editor. Recarregue com Ctrl+Shift+R, ou Cmd+Shift+R num Mac.
O relatório de estado diz "Some DXPR Builder content migrations have not been completed". Conteúdo ainda aguarda conversão. Abra View migration status nessa mensagem, ou vá a /admin/dxpr_studio/dxpr_builder/migration-status, e clique em Run all pending migrations.
As páginas parecem erradas ou faltam elementos. Veja Problems after updating para causas e correções.

Se a atualização partir o site e nada acima ajudar, reverta:

Restaure a cópia de segurança da base de dados:
```
drush sql:cli < backup-20260901.sql
```
Restaure a versão onde estava, por exemplo 3.0.0-beta19:
```
composer require 'drupal/dxpr_builder:3.0.0-beta19'
```
Reconstrua as caches:
```
drush cache:rebuild
```

E a seguir?

Backup and restore: uma rotina de cópia de segurança para conteúdo de construtor antes de grandes atualizações.
Registo de alterações: o que muda em cada versão.
Problems after updating: correções para os problemas mais comuns de atualização.