バイナリターゲットとXCFramework
クローズドソースコードをXCFrameworkとして配布し、バイナリターゲットとして利用します。
「バイナリターゲットとXCFramework」はCoddyKit上の無料Swift Academyレッスンです。 これはレッスン3/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはSwift Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Swift Academyコースには全4レッスンが含まれています。
バイナリターゲットとは
バイナリターゲットは、ソースコードではなくコンパイル済みのフレームワーク（XCFramework）を配布します。これにより、独自実装を保護できます。
// Package.swift:
.binaryTarget(
name: "ClosedSDK",
path: "Frameworks/ClosedSDK.xcframework"
)XCFrameworkとは
XCFrameworkは、複数のプラットフォーム用スライス（iOS、macOS、シミュレータ）を1つの配布可能なアーカイブにまとめたものです。
// XCFramework structure:
// ClosedSDK.xcframework/
// ├── ios-arm64/
// ├── ios-arm64_x86_64-simulator/
// └── macos-arm64_x86_64/XCFrameworkの作成
各プラットフォーム用のアーカイブをビルドし、xcodebuild -create-xcframeworkで結合します。
xcodebuild archive -scheme MySDK -destination "generic/platform=iOS" -archivePath ios.xcarchive SKIP_INSTALL=NO
xcodebuild archive -scheme MySDK -destination "generic/platform=iOS Simulator" -archivePath sim.xcarchive SKIP_INSTALL=NO
xcodebuild -create-xcframework \
-framework ios.xcarchive/Products/Library/Frameworks/MySDK.framework \
-framework sim.xcarchive/Products/Library/Frameworks/MySDK.framework \
-output MySDK.xcframeworkチェックサム付きのリモートバイナリターゲット
整合性を検証するため、SHA-256チェックサムを指定して、リモートでホストされたXCFrameworkのzipを参照します。
.binaryTarget(
name: "ClosedSDK",
url: "https://cdn.example.com/ClosedSDK-1.0.0.xcframework.zip",
checksum: "abc123def456..."
)チェックサムの計算
swift package compute-checksumを使用して、zipファイルのSHA-256チェックサムを生成します。
swift package compute-checksum ClosedSDK-1.0.0.xcframework.zip
# Outputs: abc123def456...アプリでのバイナリターゲットの使用
ソースターゲットの場合と同様に、別のターゲットのdependenciesリストにバイナリターゲットを依存関係として追加します。
.target(
name: "MyApp",
dependencies: [
.target(name: "ClosedSDK")
]
)XCFrameworkのインポート
ほかのインポートとまったく同じように、Swiftコードでモジュールをインポートします。
import ClosedSDK
let result = ClosedSDK.ProcessData(input: myData)プライバシーマニフェストの要件
Appleは、App Storeで配布するXCFrameworkに、使用するAPIを一覧化したPrivacyInfo.xcprivacyマニフェストを含めることを求めています。
// ClosedSDK.xcframework/
// ├── ios-arm64/ClosedSDK.framework/
// │ └── PrivacyInfo.xcprivacy
// └── ...DebugビルドとReleaseビルド
XCFrameworkを利用する場合、デバッガーでソースコードをステップ実行することはできず、シンボルだけが表示されます。クラッシュ時のシンボル化のために、dSYMファイルを同梱できます。
// Distribute dSYMs alongside XCFramework for crash reporting:
// ClosedSDK-1.0.0.xcframework.zip
// ClosedSDK-1.0.0.dSYM.zipXCFrameworkのバージョン管理
ファイル名とSPMパッケージのバージョンにセマンティックバージョニングを使用すると、利用側で互換性のあるバージョンを固定できます。
// ClosedSDK-1.2.0.xcframework.zip
// In Package.swift:
// .package(url: "...", from: "1.2.0")XCFrameworkとソースパッケージの比較
プロプライエタリなコード、大規模なプリコンパイル済みSDK、またはC/C++ラッパーにはXCFrameworkを使用します。オープンソースのSwiftコードにはソースパッケージを使用します。
// XCFramework: proprietary analytics SDK, vendor-provided libraries
// Source: open-source Alamofire, SwiftUI components理解度チェック
Package.swiftでリモートバイナリターゲットを宣言するとき、なぜチェックサムを含めるのでしょうか。
レッスンのまとめ
バイナリターゲットを使うと、ソースコードなしでプリコンパイル済みのXCFrameworkを配布できます。xcodebuild -create-xcframeworkでビルドし、zipをホストして、swift package compute-checksumでチェックサムを計算し、Package.swiftで宣言します。App Storeに提出する場合は、PrivacyInfo.xcprivacyを含めてください。
よくある質問
「バイナリターゲットとXCFramework」レッスンは無料ですか？
はい。「バイナリターゲットとXCFramework」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Swift Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Swift Academyコースには全4レッスンが含まれています。
「バイナリターゲットとXCFramework」で何を学びますか？
クローズドソースコードをXCFrameworkとして配布し、バイナリターゲットとして利用します。 ブラウザで直接実行するハンズオンコードでSwift Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
Swift Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのSwift Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン3/4です。
「バイナリターゲットとXCFramework」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このSwift Academyレッスンでコードを書いて実行できますか？
はい。すべてのSwift Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- Package.swift：ターゲット、プロダクト、依存関係
- ローカルパッケージと機能モジュール
- バイナリターゲットとXCFramework
- バージョニング、競合解決、Swiftプラグイン