---
url: 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/getting-started/updating'
title: 'DXPR Builder 업데이트 | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T14:04:19+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  버그 수정, 새 기능, 보안 수정을 받으려면 DXPR Builder를 업데이트합니다. Composer로 코드를 업데이트한 뒤 drush updatedb로 Drupal이 설정과 콘텐츠를 변환하도록 합니다. 3.x 시리즈 내의 업데이트에는 이 페이지를 사용합니다. 1.x나 2.x에서 가져오나요? 대신 DXPR Builder 1.x 또는 2.x에서 마이그레이션을 따릅니다.
  시작하기 전에


  데이터베이스를 백업합니다.
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-24T14:04:19+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'DXPR Builder 업데이트'
      description: |-
        버그 수정, 새 기능, 보안 수정을 받으려면 DXPR Builder를 업데이트합니다. Composer로 코드를 업데이트한 뒤 drush updatedb로 Drupal이 설정과 콘텐츠를 변환하도록 합니다. 3.x 시리즈 내의 업데이트에는 이 페이지를 사용합니다. 1.x나 2.x에서 가져오나요? 대신 DXPR Builder 1.x 또는 2.x에서 마이그레이션을 따릅니다.
        시작하기 전에


        데이터베이스를 백업합니다.
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T14:04:19+0000'
      dateModified: '2026-10-24T14:04:19+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/ko/hc/documentation/learn-dxpr-builder/getting-started/updating'
      articleSection: '설치 및 업데이트'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/getting-started/updating'
      description: |-
        버그 수정, 새 기능, 보안 수정을 받으려면 DXPR Builder를 업데이트합니다. Composer로 코드를 업데이트한 뒤 drush updatedb로 Drupal이 설정과 콘텐츠를 변환하도록 합니다. 3.x 시리즈 내의 업데이트에는 이 페이지를 사용합니다. 1.x나 2.x에서 가져오나요? 대신 DXPR Builder 1.x 또는 2.x에서 마이그레이션을 따릅니다.
        시작하기 전에


        데이터베이스를 백업합니다.
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: 홈
            item: 'https://dxpr.com/ko'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: ko
---
[도움말 센터](/ko/node/75)/[문서](/ko/hc/documentation) /[DXPR Builder 배우기](/ko/hc/documentation/learn-dxpr-builder) /[여기서 시작](/ko/hc/documentation/learn-dxpr-builder/start-here) /[설치 및 업데이트](/ko/hc/documentation/learn-dxpr-builder/start-here/install) # DXPR Builder 업데이트.

 DXPR Builder 배우기여기서 시작설치 및 업데이트

   ## 이 가이드의 내용

 관련 가이드

- [빌더 페이지 백업 및 복원](/ko/hc/documentation/learn-dxpr-builder/advanced/backup-restore)
- [변경 로그](/ko/hc/documentation/learn-dxpr-builder/getting-started/changelog)
- [업데이트 후 문제](/ko/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating)

버그 수정, 새 기능, 보안 수정을 받으려면 DXPR Builder를 업데이트합니다. Composer로 코드를 업데이트한 뒤 `drush updatedb`로 Drupal이 설정과 콘텐츠를 변환하도록 합니다. 3.x 시리즈 내의 업데이트에는 이 페이지를 사용합니다. 1.x나 2.x에서 가져오나요? 대신 [DXPR Builder 1.x 또는 2.x에서 마이그레이션](/hc/documentation/learn-dxpr-builder/getting-started/migration-1x-to-3x)을 따릅니다.

## 시작하기 전에

- 데이터베이스를 백업합니다.

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

    ```
- 먼저 [변경 로그](/hc/documentation/learn-dxpr-builder/getting-started/changelog)와 [GitHub 릴리스 페이지](https://github.com/dxpr/dxpr_builder/releases)에서 조치 필요한 변경 사항(예: [Font Awesome 7](/hc/documentation/learn-dxpr-builder/getting-started/font-awesome-7)로의 이동)을 읽습니다.
- 먼저 스테이징 복사본에서 업데이트를 시험합니다.

## 모듈 업데이트

1. 코드를 업데이트합니다.

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

    ```
2. 데이터베이스 업데이트를 실행합니다. 대신 `/update.php`를 방문해도 됩니다.

    ```bash
    drush updatedb

    ```

    일부 업데이트는 모든 DXPR Builder 필드 값을 일괄 방식으로 변환합니다. 대규모 사이트에서는 수초가 아니라 수분이 걸립니다.
3. 캐시를 다시 빌드하여 브라우저가 새 스타일시트와 스크립트를 받도록 합니다.

    ```bash
    drush cache:rebuild

    ```

## 표시 내용

DXPR Builder 콘텐츠가 있는 페이지는 이전과 같은 모습입니다. 에디터로 마우스를 올리면 컨트롤 바가 표시됩니다. 작은 변경을 하고 **저장**을 클릭하여 저장이 작동하는지 확인합니다. **일반 설정**의 **라이선스**에 여전히 제품 키가 표시됩니다.

그런 다음 **보고서** > **상태 보고서**(`/admin/reports/status`)를 엽니다. **DXPR Builder 콘텐츠 마이그레이션** 옆에 **모든 마이그레이션 완료**라고 표시됩니다.

## 새 버전이 표시되지 않는 경우

- **에디터가 여전히 이전 버전처럼 작동합니다.** 브라우저가 이전 에디터 파일을 유지하고 있습니다. Ctrl+Shift+R(Mac에서는 Cmd+Shift+R)로 다시 로드합니다.
- **상태 보고서에 “일부 DXPR Builder 콘텐츠 마이그레이션이 완료되지 않았습니다(Some DXPR Builder content migrations have not been completed)”라고 표시됩니다.** 콘텐츠가 아직 변환 대기 중입니다. 해당 메시지의 **마이그레이션 상태 보기**를 열거나 `/admin/dxpr_studio/dxpr_builder/migration-status`로 이동하여 **모든 대기 마이그레이션 실행**을 클릭합니다.
- **페이지가 잘못 표시되거나 요소가 없습니다.** 원인과 해결 방법은 [업데이트 후 문제](/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating)를 참조하세요.

업데이트로 사이트가 깨지고 위의 방법으로도 해결되지 않으면 롤백합니다.

1. 데이터베이스 백업을 복원합니다.

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

    ```
2. 사용하던 버전(예: 3.0.0-beta19)을 복원합니다.

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

    ```
3. 캐시를 다시 빌드합니다.

    ```bash
    drush cache:rebuild

    ```

## 다음 단계

- [백업 및 복원](/hc/documentation/learn-dxpr-builder/advanced/backup-restore): 대규모 업데이트 전 빌더 콘텐츠 백업 절차.
- [변경 로그](/hc/documentation/learn-dxpr-builder/getting-started/changelog): 각 릴리스의 변경 사항.
- [업데이트 후 문제](/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating): 가장 흔한 업데이트 문제 해결 방법.