不需要重新建立專案,直接手動調整既有工程的設定即可,大致分為三個步驟。
在 project.pbxproj 中,把產物型別從靜態庫(static library)改掉,拿掉 static 的設定,讓它成為 framework 產出。
接著補上下列設定,讓編譯器以模組化 framework 的方式輸出:
CLANG_WARN_UNREACHABLE_CODE = YES; CURRENT_PROJECT_VERSION = 1; ENABLE_STRICT_OBJC_MSGSEND = YES; VERSIONING_SYSTEM = "apple-generic"; DEFINES_MODULE = YES; DYLIB_INSTALL_NAME_BASE = "@rpath"; INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks"; CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES = YES;
其中幾個關鍵項值得留意:DEFINES_MODULE 決定是否產出 modulemap,讓使用者可以用 @import 引入;DYLIB_INSTALL_NAME_BASE 與 LD_RUNPATH_SEARCH_PATHS 搭配 @rpath,是動態 framework 能被正確搜尋到的前提;VERSIONING_SYSTEM 與 CURRENT_PROJECT_VERSION 則負責版本資訊的產生。
在 Build Phases 中新增一個 copy framework 的階段,把產出的 framework 複製到目標位置,整個轉換就完成了。
相較於重新開一個專案再搬移檔案,這種就地改造的做法保留了原本的 git 歷史與專案結構,風險也更低。改完之後建議先在本機編譯一次,再實際拉進一個測試用的 App 專案驗證 import 與 runtime 載入是否正常。