SAP UI5 Tools 裡配置檔案 ui5-local.yaml 的配置要點

注销發表於2022-02-20

ui5.yaml 檔案裡的檔案路徑必須用符號 /forward slash 符號。

framework 型別可以選擇 SAPUI5 或者 OpenUI5

上圖列印的資訊:

Using SAPUI5 version: 1.98.0

因為我們把版本號 1.98.0 定義在 ui5-local.yaml 檔案的 framework 區域的 version 欄位裡。

但是執行時,我們會看到這個版本號被另一個優先順序更高的設定所覆蓋:即 webapp 資料夾中的 manifest.json 中的 minUI5Version1.66.0

SAP UI5 執行時依賴的庫列表,羅列在 framework 區域的 libraries 欄位裡:

執行時會自動安裝:

Installing missing package @sapui5/distribution-metadata...
info normalizer:ui5Framework:npm:Installer Installing missing package @sapui5/sap.suite.ui.generic.template...
info normalizer:ui5Framework:npm:Installer Installing missing package @sapui5/sap.ui.generic.app...
info normalizer:ui5Framework:npm:Installer Installing missing package @sapui5/sap.ui.comp...
info normalizer:ui5Framework:npm:Installer Installing missing package @sapui5/sap.ushell...
info normalizer:ui5Framework:npm:Installer Installing missing package @openui5/sap.f...
info normalizer:ui5Framework:npm:Installer Installing missing package @openui5/sap.ui.core...
info normalizer:ui5Framework:npm:Installer Installing missing package @openui5/sap.m...
info normalizer:ui5Framework:npm:Installer Installing missing package @openui5/sap.ui.table...
info normalizer:ui5Framework:npm:Installer Installing missing package @sapui5/sap.fe.placeholder...

如果需要將某些不相關的資源比如單元測試和整合測試排除在最後的構建結果中,可以使用如下語法:

builder:
  resources:
    excludes:
      - "/resources/some/project/name/test_results/**"
      - "/test-resources/**"
      - "!/test-resources/some/project/name/demo-app/**"

SAP UI5 Tools 預設使用 8080 埠。

如果想修改預設埠,使用語法:

server:
  settings:
    httpPort: 1337
    httpsPort: 1443

命令列 ui5 tree:以圖形介面顯示該專案的依賴資訊:

執行 ui5 build, 在 dist 資料夾裡生成 Component-preload.js

(1/8) Running task escapeNonAsciiCharacters...
info builder:builder application project1 (2/8) Running task replaceCopyright...
info builder:builder application project1 (3/8) Running task replaceVersion...
info builder:builder application project1 (4/8) Running task generateFlexChangesBundle...
info builder:builder application project1 (5/8) Running task generateComponentPreload...
info builder:builder application project1 (6/8) Running task createDebugFiles...
info builder:builder application project1 (7/8) Running task uglify...
info builder:builder application project1 (8/8) Running task generateVersionInfo...

使用 ui5 build --allsap-ui-core.js 等依賴一起構建到最終的 package 裡。

通常,我們建議全域性安裝 UI5 CLI (npm install --global @ui5/cli)。

但是,將 UI5 CLI 作為 devDependency (npm install --save-dev @ui5/cli) 新增到專案的 package.json 是有意義的。 這確保了每個從事該專案的開發人員都使用相同版本的 UI5 CLI,並且您的持續整合環境也使用此版本。

如果您同時擁有一個專案中的本地安裝和全域性安裝,UI5 CLI 將始終嘗試呼叫本地安裝。 這部分是因為 package.json 中定義的 npm 指令碼也將始終呼叫本地安裝。

可以透過設定環境變數 UI5_CLI_NO_LOCAL 停用此行為。

更多Jerry的原創文章,盡在:"汪子熙":

相關文章