本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 Amplify 控制台中編輯構建規格

您可以在 Amplify 控制台中編輯構建規格來自定義應用程序的構建設置。構建設置將應用於應用程序中的所有分支，但在 Git 存儲庫中保存了amplify.yml文件的分支除外。

您可以使用下列主題中描述的範例來更新特定案例的組建設定。

使用腳本設置分支特定的構建設置

您可以使用 bash shell 指令碼來配置分支特定的建置設定。例如，如果分支名稱為 main，則下列指令碼會使用系統環境變數 $ AWS_BRANCH 執行一組指令，如果分支名稱為 dev，則使用不同的指令集。

frontend:
  phases:
    build:
      commands:
        - if [ "${AWS_BRANCH}" = "main" ]; then echo "main branch"; fi
        - if [ "${AWS_BRANCH}" = "dev" ]; then echo "dev branch"; fi

設置導航到子文件夾的命令

對於壟斷，用戶希望能夠cd進入一個文件夾來運行構建。執行cd命令之後，它會套用至組建的所有階段，因此您不需要在不同階段重複指令。

version: 1
env:
  variables:
    key: value
frontend:
  phases:
    preBuild:
      commands:
        - cd react-app
        - npm ci
    build:
      commands:
        - npm run build

使用 Gen 1 應用程式的前端部署後端

此命amplifyPush令是協助程式指令碼，可協助您進行後端部署。下面的建置設定會自動判斷要為目前分支部署的正確後端環境。

version: 1
env:
  variables:
    key: value
backend:
  phases:
    build:
      commands:
        - amplifyPush --simple

設置輸出文件夾

以下建置設定會將輸出目錄設定為公有資料夾。

frontend:
  phases:
    commands:
      build:
        - yarn run build
  artifacts:
    baseDirectory: public

將套件安裝為組建的一部分

您可以在建置期間使用npm或yarn指令來安裝套件。

frontend:
  phases:
    build:
      commands:
        - npm install -g <package>
        - <package> deploy
        - yarn run build
  artifacts:
    baseDirectory: public

使用私有 npm 註冊表

您可以新增對您的建置設定中私有登錄的參考，或將它新增為環境變數。

build:
  phases:
    preBuild:
      commands:
        - npm config set <key> <value>
        - npm config set registry https://registry.npmjs.org
        - npm config set always-auth true
        - npm config set email hello@amplifyapp.com
        - yarn install

安裝 OS 套件

Amplify 的 AL2 023 映像檔會以名為的非特權使用者執行您的程式碼。amplifyAmplify 會授與此使用者使用 Linux sudo 命令執行作業系統命令的權限。如果您想要安裝作業系統套件以尋找遺失的相依性，您可以使rpm用yum和sudo.

下面的示例構建部分演示了使用sudo命令安裝操作系統包的語法。

build:
  phases:
    preBuild:
      commands:
        - sudo yum install -y <package>

為每個構建設置鍵值存儲

在建置階段envCache提供索引鍵值儲存。儲存在中的值只envCache能在建置期間修改，而且可以在下一個組建中重複使用。使用envCache，我們可以儲存已部署環境的相關資訊，並在連續組建中將其提供給組建容器。與儲存在中的值不同envCache，組建期間對環境變數的變更不會保留在 future 的組建中。

使用範例：

envCache --set <key> <value>
envCache --get <key>

跳過提交的構建

要在特定提交上跳過自動構建，請在提交消息末尾添加文本 [skip p-cd]。

關閉每次提交時的自動構建

您可以將 Amplify 設定為關閉每個程式碼提交時的自動建置。若要進行設定，請選擇 [應用程式設定]、[分支設定]，然後找到列出連線分支的 [分支] 區段。選取分支，然後選擇 [動作] > [停用 auto 建置]。對該分支的新提交將不再啟動新的構建。

配置基於差異的前端構建和部署

您可以將「Amplify」設定為使用基於差異的前端組建。如果啟用，則在每個構建啟動時，Amplify 會默認嘗試在您appRoot的或/src/文件夾上運行 diff。如果 Amplify 找不到任何差異，它會略過前端組建、測試 (如果已設定) 和部署步驟，而不會更新您的託管應用程式。

或者，您可以設置AMPLIFY_DIFF_DEPLOY_ROOT環境變量，以使用相對於存儲庫根目錄的路徑覆蓋默認路徑，例如dist。

為第 1 代應用程式設定基於差異的後端建置

您可以將 Amplify 託管配置為使用AMPLIFY_DIFF_BACKEND環境變量使用基於差異的後端構建。當您啟用基於差異的後端構建時，在每個構建開始時，Amplify 會嘗試對存儲庫中的amplify文件夾運行差異。如果 Amplify 沒有發現任何差異，它會跳過後端構建步驟，並且不會更新後端資源。如果您的專案在儲存庫中沒有amplify資料夾，Amplify 會忽略AMPLIFY_DIFF_BACKEND環境變數的值。

如果您當前在後端階段的構建設置中指定了自定義命令，則條件後端構建將無法正常工作。如果要運行這些自定義命令，則必須將它們移動到應用程序amplify.yml文件中構建設置的前端階段。