---
url: 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/atualizar'
title: 'Atualizar o DXPR Builder | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T14:12:04+00:00'
updated: '2026-10-24T17:19:22+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  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:
tags:
  - 'Install and update'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T17:19:22+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'Atualizar o DXPR Builder'
      description: |-
        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:
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T14:12:04+0000'
      dateModified: '2026-10-24T17:19:22+0000'
      author:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      mainEntityOfPage: 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/atualizar'
      articleSection: 'Instalar e atualizar'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/atualizar'
      description: |-
        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:
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: Início
            item: 'https://dxpr.com/pt-pt'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: pt-pt
---
[Centro de ajuda](/pt-pt/node/75)/[Documentação](/pt-pt/hc/documentacao) /[Aprender DXPR Builder](/pt-pt/hc/documentation/learn-dxpr-builder) /[Comece aqui](/pt-pt/hc/documentation/learn-dxpr-builder/start-here) /[Instalar e atualizar](/pt-pt/hc/documentation/learn-dxpr-builder/start-here/install) # Atualizar o DXPR Builder.

 Aprender DXPR BuilderComece aquiInstalar e atualizar

   ## Neste guia

 Guias relacionados

- [Criar cópias de segurança e restaurar as páginas do construtor](/pt-pt/hc/documentacao/aprender-dxpr-builder/avancado/copia-de-seguranca-e-restauro)
- [Registo de alterações](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/registo-de-alteracoes)
- [Problemas depois de atualizar](/pt-pt/hc/documentacao/aprender-dxpr-builder/resolucao-de-problemas/depois-de-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](/pt-pt/hc/documentation/learn-dxpr-builder/getting-started/migration-1x-to-3x).

## Antes de começar

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

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

    ```
- Leia o [Registo de alterações](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/registo-de-alteracoes) e a [página de versões GitHub](https://github.com/dxpr/dxpr_builder/releases)para mudanças que exigem ação, como a passagem para [Font Awesome 7 no DXPR Builder](/pt-pt/hc/documentation/learn-dxpr-builder/getting-started/font-awesome-7).
- Experimente a atualização primeiro numa cópia de teste do site.

## Atualizar o módulo

1. Atualize o código:

    ```bash
    composer update drupal/dxpr_builder --with-dependencies

    ```
2. Corra as atualizações da base de dados. Também pode visitar `/update.php`:

    ```bash
    drush updatedb

    ```

    Algumas atualizações convertem cada valor de campo DXPR Builder em lotes. Em sites grandes demoram minutos, não segundos.
3. Reconstrua as caches, para que os navegadores recebam as novas folhas de estilo e scripts:

    ```bash
    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**.

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](/pt-pt/hc/documentacao/aprender-dxpr-builder/resolucao-de-problemas/depois-de-atualizar) para causas e correções.

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

1. Restaure a cópia de segurança da base de dados:

    ```bash
    drush sql:cli < backup-20260901.sql

    ```
2. Restaure a versão onde estava, por exemplo 3.0.0-beta19:

    ```bash
    composer require 'drupal/dxpr_builder:3.0.0-beta19'

    ```
3. Reconstrua as caches:

    ```bash
    drush cache:rebuild

    ```

## E a seguir?

- [Backup and restore](/pt-pt/hc/documentacao/aprender-dxpr-builder/avancado/copia-de-seguranca-e-restauro): uma rotina de cópia de segurança para conteúdo de construtor antes de grandes atualizações.
- [Registo de alterações](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/registo-de-alteracoes): o que muda em cada versão.
- [Problems after updating](/pt-pt/hc/documentacao/aprender-dxpr-builder/resolucao-de-problemas/depois-de-atualizar): correções para os problemas mais comuns de atualização.