合成檔案

Tuist 能在專案生成階段產生檔案與程式碼，讓管理與使用 Xcode 專案更便利。本頁將說明此功能，以及如何在你的專案中使用。

目標資源#

Xcode 專案支援為目標加入資源。然而，這會為團隊帶來若干挑戰，特別是在模組化專案中，原始碼與資源經常需要搬移：

執行階段存取不一致：資源在最終產品中的位置與存取方式取決於目標的產品類型。例如，若你的目標代表應用程式，資源會被複製到應用程式套件中。這會導致存取資源的程式碼對套件結構做出假設，並不理想，因為這會讓程式碼較難理解，也讓資源搬移變得困難。
不支援資源的產品類型：某些產品類型（例如靜態函式庫）並非套件，因此不支援資源。因此，你必須改用其他產品類型，例如框架，但這可能為專案或應用程式帶來額外負擔。例如，靜態框架會以靜態方式連結至最終產品，且需要額外的建置階段才能將資源複製到最終產品。若是動態框架，Xcode 會將二進位檔與資源都複製到最終產品，但由於框架需要動態載入，會增加應用程式的啟動時間。
容易發生執行階段錯誤：資源透過名稱與副檔名（字串）來識別。因此，任何拼寫錯誤都會在嘗試存取資源時導致執行階段錯誤。這並不理想，因為編譯時期無法偵測，可能在正式版中造成當機。

Tuist 透過合成統一的介面來存取套件與資源，抽象化實作細節，從而解決上述問題。

建議做法

雖然並非強制要求透過 Tuist 合成的介面存取資源，但我們建議採用，因為這能讓程式碼更易於理解，也方便資源搬移。

Tuist 提供介面，讓你以 Swift 宣告如 Info.plist 或權限設定等檔案的內容。這有助於確保各目標與專案之間的一致性，並利用編譯器在編譯時期捕捉問題。你也可以自行設計抽象層來建模內容，並在目標與專案間共用。

當你的專案被生成時，Tuist 會合成這些檔案的內容，並將它們寫入相對於定義該專案之目錄下的 Derived 目錄。

將 Derived 目錄加入 .gitignore

我們建議將 Derived 目錄加入專案的 .gitignore 檔案。

Tuist 會合成一個介面，用於存取包含目標資源的套件。

目標會包含 Bundle 型別的擴充，用以暴露該套件：

swift

let bundle = Bundle.module

在 Objective-C 中，你會獲得一個 {Target}Resources 介面來存取套件：

objc

NSBundle *bundle = [MyFeatureResources bundle];

內部目標的限制

目前，Tuist 不會為僅包含 Objective-C 原始碼的內部目標產生資源套件存取器。這是已知限制，追蹤於 issue #6456。

透過套件讓函式庫支援資源

若目標產品（例如函式庫）不支援資源，Tuist 會將資源放入產品類型為 bundle 的目標中，確保其出現在最終產品內，且介面指向正確的套件。這些合成的套件會自動標記為 tuist:synthesized，並繼承父目標的所有標籤，讓你能在快取設定檔中針對它們進行設定。

資源透過名稱與副檔名（字串）來識別。這並不理想，因為編譯時期無法偵測，可能在正式版中造成當機。為避免此問題，Tuist 在建置專案生成流程時整合了 SwiftGen，以合成存取資源的介面。藉此，你可以放心地存取資源，並依靠編譯器捕捉任何問題。

Tuist 預設包含範本，用於為下列資源類型合成存取器：

注意：你可以透過將 disableSynthesizedResourceAccessors 選項傳入專案選項，針對單一專案停用資源存取器的合成功能。

若你想提供自己的範本來為其他資源類型合成存取器（必須由 SwiftGen 支援），你可以在 Tuist/ResourceSynthesizers/{name}.stencil 建立範本，其中名稱為資源的駝峰式命名。

若要設定要合成存取器的資源類型清單，你可以使用 Project.resourceSynthesizers 屬性並傳入想使用的資源合成器清單：

swift

let project = Project(resourceSynthesizers: [.string(), .fonts()])

參考

你可以查看此範例，了解如何使用自訂範本來合成資源存取器。