iOS プロジェクト構成

cargo tauri ios init が生成するもの、gen/apple ディレクトリ、Info.ios.plist、bundle.iOS 設定

このページでは、Tauri プロジェクトで iOS を有効にしたときに追加されるファイル、iOS 固有ファイルが置かれる場所、そして tauri.conf.json のどのフィールドが実際に Xcode の挙動を左右するかを扱う。

cargo tauri ios init の実行

tauri.conf.json のあるディレクトリ（通常は src-tauri/）で実行する:

cargo tauri ios init

内部では cargo-mobile2 が動き、Xcode プロジェクトを scaffolding する。初回は依存のコンパイル、CocoaPods の配線、Xcode プロジェクト生成で数分かかる。

生成されるもの

ios init 後、プロジェクトに gen/ ディレクトリが追加される:

src-tauri/
  Cargo.toml
  tauri.conf.json
  Info.ios.plist           # (必要なときに自分で作る)
  src/
    lib.rs                 # モバイル用エントリポイントとして `run` をエクスポート
  gen/
    apple/                 # iOS 固有の出力
      Podfile
      project.yml          # XcodeGen プロジェクト定義
      <AppName>.xcodeproj/ # 生成された Xcode プロジェクト
      <AppName>_iOS/
        <AppName>_iOS.entitlements  # capability entitlements
      Assets.xcassets/
      LaunchScreen.storyboard
      Sources/
        main.mm            # Rust への橋渡しをする Objective-C++ エントリポイント

gen/apple/ ディレクトリは project.yml から生成される。cargo tauri ios init や cargo tauri ios dev/build を実行するたびに XcodeGen が project.yml を読み直し .xcodeproj を生成する。.xcodeproj を直接編集した内容は上書きされるリスクがある。

lib.rs は run をエクスポートする必要がある

モバイル用エントリポイントは tauri_lib::run() を呼ぶ。src/lib.rs はおおよそ次のようになる:

#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
    tauri::Builder::default()
        .setup(|_app| Ok(()))
        .invoke_handler(tauri::generate_handler![])
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

main.rs はライブラリを呼ぶだけでよい:

fn main() {
    app_lib::run()
}

app_lib は実際のクレートの lib 名に置き換える（Cargo.toml の [lib] で設定する）。lib.rs がまだない場合は追加し、Cargo.toml を更新する:

[lib]
name = "app_lib"
crate-type = ["staticlib", "cdylib", "rlib"]

staticlib が iOS ビルド時に実際にリンクされるクレートタイプである。これがないと cargo tauri ios build は失敗する。

tauri.conf.json > bundle.iOS

iOS 固有のバンドル設定は bundle.iOS の下に書く:

{
  "bundle": {
    "active": true,
    "targets": "all",
    "iOS": {
      "developmentTeam": "ABCD123456",
      "minimumSystemVersion": "14.0",
      "frameworks": ["CoreHaptics", "WebKit"],
      "bundleVersion": "1"
    }
  }
}

identifier のルール

tauri.conf.json のトップレベルの identifier が iOS のバンドル ID になる:

{
  "identifier": "com.takazudo.myapp"
}

Apple Developer ポータルで登録した App ID（または Personal Team 用に Xcode が自動生成したもの）と一致している必要がある。慣習として逆 DNS 形式（com.<org>.<app>）を使う。

Info.ios.plist: 追加キーのマージ

Tauri は CFBundleShortVersionString、CFBundleVersion など基本キーを含んだ Info.plist を自前で生成する。カメラ使用許可、ATS 例外、URL スキームハンドラなど追加のキーが必要なら、tauri.conf.json の隣に Info.ios.plist を作る:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>NSCameraUsageDescription</key>
    <string>This app uses the camera to scan QR codes.</string>
    <key>NSPhotoLibraryUsageDescription</key>
    <string>This app needs access to your photos to attach images.</string>
    <key>UIViewControllerBasedStatusBarAppearance</key>
    <false/>
</dict>
</plist>

ここで定義したキーは生成済みの Info.plist にマージされる。デスクトップと iOS 共通のキーは通常の Info.plist に置いても良い — Tauri は両方を読む。

Entitlements ファイル

Push 通知、App Groups、Associated Domains など entitlement が必要な capability は gen/apple/<AppName>_iOS/<AppName>_iOS.entitlements で管理される。このファイルは再生成されるため、編集は注意:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>aps-environment</key>
    <string>development</string>
</dict>
</plist>

実際には、無料の Personal Team ではこれらの capability を付与できないので、有料 Apple Developer Program に加入するまでこのファイルを触る機会はほぼない。

.gitignore の追加

iOS を有効にした Tauri プロジェクトでは既存の .gitignore を拡張する:

/target/
/gen/apple/Pods/
/gen/apple/Externals/
/gen/apple/build/

gen/apple/ の残りを無視するかどうかは判断が分かれる。Xcode プロジェクトをコミットしておけば GUI でビルド設定を調整しやすくなるが、その代わり “project.yml を編集 > 再 init” のワークフローを捨てることになる。安全なデフォルトは gen/ ごと無視して CI で再生成することである。

iOS バージョンマトリクス

フロントエンドが実際に使う Web API をサポートする最低バージョンを選ぶ。詳細は caniuse.com を Safari-iOS でフィルタして確認すると良い。

公式ドキュメント

• Tauri Project Structure
• Tauri Configuration Reference
• App Store Submission