> For the complete documentation index, see [llms.txt](https://frost.gitbook.io/iosbook/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://frost.gitbook.io/iosbook/ios/ios-book/ios-build-a-universal-framework-for-ios-using-swift.md).

# \[iOS] Build a Universal Framework for iOS using Swift

## 建立Cocoa Touch Framework

(1.) 打開Xcode, 建立一個Cocoa Touch Framework專案名為testFramework

![](/files/-LI1bjtNb4EbFcneWWew)

打開專案會看到以下結構:

![](/files/-LI1chW9k0APKVip3nV-)

(2.) 將你的程式碼放進testFramework目錄下\
       需注意: Cocoa Touch Framework裡面所有的Class都必須是**public**或**open**的封裝

![](/files/-LI1e8klQRv2D3SGNi_X)

(3.)  按下Build按鈕, 你會在Products資料夾下找到你的framework檔案.

        此時的framework只能支援simulator 或 device 其中一種, 根據你build的時候所選擇的環境.

        如下圖選擇的是simulator  (iPhone X)

![](/files/-LI1d93crxcRJX5cwEnG)

## 建立Universal Framework

(1.) 新增一個target, 選擇**Cross-platform -> Aggregate**

![](/files/-LI1fEImfKQlFtoQqpnR)

名為UniversalFramework

![](/files/-LI1fX0Lp5Tx3RufsRHi)

(2.) 到UniversalFramework Target的**Build Phase,** 按**+**按鈕, 新增一個**Run Script Phase**

![](/files/-LI1gBhJNBRUXLy_q_1q)

(3.) 輸入以下Script

```javascript
#!/bin/sh

UNIVERSAL_OUTPUTFOLDER=${BUILD_DIR}/${CONFIGURATION}-universal

# make sure the output directory exists
mkdir -p "${UNIVERSAL_OUTPUTFOLDER}"

# Step 1. Build Device and Simulator versions
xcodebuild -target "${PROJECT_NAME}" ONLY_ACTIVE_ARCH=NO -configuration ${CONFIGURATION} -sdk iphoneos  BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" clean build
xcodebuild -target "${PROJECT_NAME}" -configuration ${CONFIGURATION} -sdk iphonesimulator ONLY_ACTIVE_ARCH=NO BUILD_DIR="${BUILD_DIR}" BUILD_ROOT="${BUILD_ROOT}" clean build

# Step 2. Copy the framework structure (from iphoneos build) to the universal folder
cp -R "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework" "${UNIVERSAL_OUTPUTFOLDER}/"

# Step 3. Copy Swift modules from iphonesimulator build (if it exists) to the copied framework directory
SIMULATOR_SWIFT_MODULES_DIR="${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework/Modules/${PROJECT_NAME}.swiftmodule/."
if [ -d "${SIMULATOR_SWIFT_MODULES_DIR}" ]; then
cp -R "${SIMULATOR_SWIFT_MODULES_DIR}" "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework/Modules/${PROJECT_NAME}.swiftmodule"
fi

# Step 4. Create universal binary file using lipo and place the combined executable in the copied framework directory
lipo -create -output "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework/${PROJECT_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework/${PROJECT_NAME}" "${BUILD_DIR}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework/${PROJECT_NAME}"

# Step 5. Convenience step to copy the framework to the project's directory
cp -R "${UNIVERSAL_OUTPUTFOLDER}/${PROJECT_NAME}.framework" "${PROJECT_DIR}"

# Step 6. Convenience step to open the project's directory in Finder
open "${PROJECT_DIR}"
```

![](/files/-LI1gR-0HRBPMVmCAmWH)

(4.) Build UniversalFramework Target, 完成後,  打開framework檔案的目錄

![](/files/-LI1h03870l7gsw0Ep8d)

你會看到有一個universal的資料夾, 裡面的framework檔案即是**simulator & device通用**的Universal Framework .

![](/files/-LI1hBukv1gE8jN1RW6Q)