Rork アプリで CarPlay 対応を実装する — 音楽・ナビ・メッセージを車載で動かす設計と App Store 審査の勝ち方

エンタイトルメント申請 — 通る申請書の書き方

CarPlay エンタイトルメントの申請は、Apple の専用フォーム から行います。このフォームは一見シンプルですが、実は 3 つの見えない評価軸があり、ここを外すと却下されます。

1 つ目の評価軸は「なぜこのアプリが CarPlay 対応でなければならないのか」という必然性です。Apple は「スマホで使えば十分なアプリ」を CarPlay で動かすことを認めません。運転中にしか発生しないユースケース、運転中だからこそ価値がある機能を明確に説明する必要があります。

2 つ目が「運転中の安全性への配慮」です。CarPlay アプリは視線移動を最小化する設計になっていなければなりません。申請書では、テキスト量の制限、タップ領域の大きさ、音声フィードバックの設計などを具体的に記述します。

3 つ目が「カテゴリ適合性」です。Audio カテゴリで申請するならオーディオ再生がアプリの主要機能でなければならず、Navigation カテゴリで申請するならターンバイターンナビゲーションを独自に実装している必要があります。既存の Apple Maps や Google Maps を呼び出すだけでは通りません。

実際の申請文の構成例を示します。

App Name: DriveRadio by Rork Lab
Requested Entitlement: com.apple.developer.carplay-audio
Primary Category: Audio Streaming
 
Why CarPlay is essential for this app:
DriveRadio は、ユーザーが自分のドライブ履歴（GPS 走行ログ）に
基づいて生成されるパーソナライズド・ラジオ番組を提供するアプリです。
運転中にしか得られないコンテキスト（現在位置・速度・過去のルート）を
番組生成に使用するため、運転中の利用が本質的な価値です。
 
Safety considerations:
- すべての UI は CPListTemplate と CPNowPlayingTemplate のみで構成
- 最大 3 タップ以内で任意の番組にアクセス可能
- テキストは全項目 36 字以内に制限
- 音声フィードバックで選択項目を読み上げ
 
Expected launch timeline: 2026 年 Q3
Expected user base in first year: 月間アクティブユーザー 10,000 人を想定

個人開発者の場合、申請が通るまでに初回で 2〜4 週間、却下後の再申請でさらに数週間かかることが一般的です。私は最初の 2 回は却下されました。1 回目はカテゴリ適合性の説明が弱く、2 回目は安全性への配慮が曖昧でした。3 回目で上記の構成に書き直したら 10 日で承認されました。

UIScene 設定 — Info.plist に CarPlay シーンを追加する

エンタイトルメントが取得できたら、次は Info.plist に CarPlay シーンを追加します。Rork で生成された Expo プロジェクトの場合、ios/YourApp/Info.plist を直接編集するか、app.json の plugins 経由で設定します。

<key>UIApplicationSceneManifest</key>
<dict>
    <key>UIApplicationSupportsMultipleScenes</key>
    <true/>
    <key>UISceneConfigurations</key>
    <dict>
        <key>CPTemplateApplicationSceneSessionRoleApplication</key>
        <array>
            <dict>
                <key>UISceneClassName</key>
                <string>CPTemplateApplicationScene</string>
                <key>UISceneConfigurationName</key>
                <string>CarPlay Configuration</string>
                <key>UISceneDelegateClassName</key>
                <string>$(PRODUCT_MODULE_NAME).CarPlaySceneDelegate</string>
            </dict>
        </array>
        <key>UIWindowSceneSessionRoleApplication</key>
        <array>
            <dict>
                <key>UISceneClassName</key>
                <string>UIWindowScene</string>
                <key>UISceneConfigurationName</key>
                <string>Default Configuration</string>
                <key>UISceneDelegateClassName</key>
                <string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
            </dict>
        </array>
    </dict>
</dict>

この設定が示しているのは、アプリには「通常の iPhone 画面用のシーン」と「CarPlay 画面用のシーン」の 2 種類が存在するということです。それぞれ独立したシーンデリゲートを持ち、ライフサイクルも独立しています。つまり iPhone 側で画面を閉じても、CarPlay 側では別のシーンが動き続けます。

ここで注意したいのは、$(PRODUCT_MODULE_NAME) の部分です。React Native + Expo の場合、モジュール名が自動生成されるため、ここを固定文字列に書き換えるとビルドが通らなくなります。必ずビルド変数として残してください。私はここで半日溶かしました。

CPTemplate API の使い分け — Audio・Navigation・Communication で変わる設計

CarPlay 対応の中核が CPTemplate API です。Apple はカテゴリごとに使用できるテンプレートを厳密に制限しており、Audio カテゴリで Navigation 系テンプレートを使うと審査でリジェクトされます。

Audio カテゴリで使うべきテンプレートは以下です。

• CPListTemplate: 曲・アルバム・プレイリストなどの一覧表示
• CPTabBarTemplate: 「音楽」「Podcast」「ライブラリ」などのタブ分け
• CPNowPlayingTemplate: 再生中画面（Apple がデフォルト UI を提供するため独自実装不要）
• CPGridTemplate: 最大 8 個のグリッドボタン（お気に入りカテゴリなど）

Navigation カテゴリでは、CPMapTemplate、CPRouteChoicesTemplate、CPSearchTemplate などが利用可能ですが、地図描画は独自のレンダラを実装する必要があります。MapKit をそのまま CarPlay に出すことはできません。

Communication カテゴリでは、CPListTemplate で連絡先を表示し、CPPointOfInterestTemplate で位置情報付きメッセージを扱います。メッセージ本文は必ず Siri による音声読み上げが可能な形式でなければなりません。

実装例として、Audio カテゴリの最小構成を示します。

import CarPlay
 
class CarPlaySceneDelegate: UIResponder, CPTemplateApplicationSceneDelegate {
 
    var interfaceController: CPInterfaceController?
 
    func templateApplicationScene(
        _ templateApplicationScene: CPTemplateApplicationScene,
        didConnect interfaceController: CPInterfaceController
    ) {
        self.interfaceController = interfaceController
 
        let nowPlayingButton = CPNowPlayingButton { _ in
            interfaceController.pushTemplate(
                CPNowPlayingTemplate.shared,
                animated: true,
                completion: nil
            )
        }
 
        let episodes = loadEpisodes()
        let items = episodes.map { episode in
            CPListItem(
                text: episode.title,
                detailText: episode.duration,
                image: episode.artwork
            )
        }
 
        let section = CPListSection(items: items)
        let listTemplate = CPListTemplate(
            title: "最新エピソード",
            sections: [section]
        )
        listTemplate.trailingNavigationBarButtons = [nowPlayingButton]
 
        interfaceController.setRootTemplate(listTemplate, animated: false) { _, error in
            if let error = error {
                print("CarPlay root template error: \(error)")
            }
        }
    }
 
    func templateApplicationScene(
        _ templateApplicationScene: CPTemplateApplicationScene,
        didDisconnectInterfaceController interfaceController: CPInterfaceController
    ) {
        self.interfaceController = nil
    }
}

このコードの肝は CPNowPlayingTemplate.shared を直接 push している点です。再生中画面は Apple が共通 UI を提供しているため、独自実装を書くと逆に審査で却下されます。Apple の提供するデフォルトに乗ることが、CarPlay 開発の鉄則です。

iPhone 側と CarPlay 側のデータ共有 — 共有 UserDefaults と App Group

CarPlay シーンは iPhone 側のアプリとは別プロセスで動作するため、通常のインメモリ状態や AsyncStorage は共有できません。データを共有するには、App Group を有効化し、共有 UserDefaults または共有 Container にデータを書き込む必要があります。

Rork + Expo の場合、app.json に以下を追加します。

{
  "expo": {
    "ios": {
      "entitlements": {
        "com.apple.security.application-groups": [
          "group.com.yourcompany.yourapp"
        ]
      }
    }
  }
}

iPhone 側から CarPlay 側にデータを渡すには、React Native 側で Native Module を作り、共有 UserDefaults にエピソード一覧を書き込みます。

@objc(SharedStorage)
class SharedStorage: NSObject {
 
    @objc func saveEpisodes(_ episodes: NSArray, resolver: RCTPromiseResolveBlock,
                            rejecter: RCTPromiseRejectBlock) {
        guard let defaults = UserDefaults(suiteName: "group.com.yourcompany.yourapp") else {
            rejecter("ERR_NO_SUITE", "App Group not configured", nil)
            return
        }
        defaults.set(episodes, forKey: "carplay_episodes")
        resolver(nil)
    }
 
    @objc static func requiresMainQueueSetup() -> Bool { false }
}

このコードで補っておきたい点が 2 つあります。

1 つは synchronize() を呼んでいないことです。手動の同期は以前から非推奨とされており、書き込みは適切なタイミングで反映されます。呼んでも害はないものの、「呼んだから確実に届いた」と思い込む材料になるだけで、実際の不整合はプロセス間の読み取り時点のほうにあります。

もう 1 つは、Swift のクラスを JavaScript 側から見えるようにする登録です。ここを忘れると NativeModules.SharedStorage が undefined になり、App Group 側ではなく JS 側で落ちます。ブリッジのヘッダに 1 行を置いてください。

// SharedStorage.m
#import <React/RCTBridgeModule.h>
 
@interface RCT_EXTERN_MODULE(SharedStorage, NSObject)
 
RCT_EXTERN_METHOD(saveEpisodes:(NSArray *)episodes
                  resolver:(RCTPromiseResolveBlock)resolve
                  rejecter:(RCTPromiseRejectBlock)reject)
 
@end

CarPlay 側では同じ suite から読み取ります。ここでよくある間違いが、UserDefaults.standard を使ってしまうことです。standard は iPhone 側・CarPlay 側で別々になるため、共有できません。必ず UserDefaults(suiteName:) を使ってください。

データ量が大きい場合（画像バイナリなど）は、共有 App Group Container のファイルシステムに書き込み、パスだけを UserDefaults で共有する方式が現実的です。

テストとデバッグ — CarPlay Simulator の活用

CarPlay の実機テストには当然ながら対応車種が必要ですが、開発中は Xcode の CarPlay Simulator で十分です。Xcode の Window > Devices and Simulators > CarPlay から CarPlay ウィンドウを開くと、iPhone Simulator と連動して CarPlay 画面が表示されます。

デバッグで特に注意したいのは、シーンライフサイクルの扱いです。didConnect は CarPlay ケーブルが接続されたタイミングで呼ばれますが、シミュレータでは Xcode 起動時に毎回呼ばれる動作になります。本番環境では「すでに接続済みだが、iPhone を再起動した」というケースを考慮して、状態復元ロジックを必ず入れてください。

また、CPListItem の画像にも上限があります。ここで私が最初に書いたのは、調べた数値をそのまま定数にしたコードでした。結果は芳しくありませんでした。上限はアプリのカテゴリによって変わるため、ある車では出ていた画像が別の車では出ない、という再現しづらい報告に追われることになったのです。

Apple は上限そのものを CPListItem.maximumImageSize として公開しております。ポイント単位の解像度非依存の値で、実行時のカテゴリに応じた値が返ります。数値を持つのではなく、問い合わせるほうが安全です。

extension UIImage {
    /// CarPlay のリスト用に、実行時の上限へ収めた画像を返す
    func fittedForCarPlayList(scale: CGFloat) -> UIImage {
        let limit = CPListItem.maximumImageSize
        guard size.width > limit.width || size.height > limit.height else { return self }
 
        let ratio = min(limit.width / size.width, limit.height / size.height)
        let target = CGSize(width: size.width * ratio, height: size.height * ratio)
 
        let format = UIGraphicsImageRendererFormat.default()
        format.scale = scale
        format.opaque = false
        return UIGraphicsImageRenderer(size: target, format: format).image { _ in
            draw(in: CGRect(origin: .zero, size: target))
        }
    }
}

上限を超えた画像は表示されないだけで、例外もログも出ません。気づきにくい落とし穴です。

もう一つ、静かに壊れるのがリストの件数です。CPListTemplate には表示できる項目数とセクション数の上限があり、超えた分は例外もログもなく単に切り捨てられます。上限値は OS のバージョンで変わりうるため、数値をコードに直書きせず、実行時に API から読んで丸める書き方をしております。

extension CPListTemplate {
    /// 実行時の上限値でセクションを丸めてから生成する
    static func clamped(title: String, sections: [CPListSection]) -> CPListTemplate {
        let maxSections = min(sections.count, CPListTemplate.maximumSectionCount)
        var remaining = CPListTemplate.maximumItemCount
        var safeSections: [CPListSection] = []
 
        for section in sections.prefix(maxSections) {
            guard remaining > 0 else { break }
            let items = Array(section.items.prefix(remaining))
            remaining -= items.count
            safeSections.append(CPListSection(items: items, header: section.header, sectionIndexTitle: nil))
        }
        return CPListTemplate(title: title, sections: safeSections)
    }
}

maximumItemCount はテンプレート全体での合計です。セクションごとに上限があると思い込んで実装すると、後ろのセクションだけが車内で消えるという再現しづらい不具合になります。私はここで一度、実機でしか起きない「最後の 1 カテゴリだけ表示されない」現象に丸一日を使いました。

もう一点、シミュレータで見落としがちなのが描画速度です。CarPlay ウィンドウは母艦の Mac の性能で動くため、リスト構築に多少の重さがあっても気づけません。実際のヘッドユニットは処理性能が控えめで、体感が明確に落ちます。私はテンプレート生成を 16ms 以内に収めることを目安にし、画像の読み込みは必ず非同期にしたうえで、プレースホルダを先に返す構成にしております。

切断時の挙動も、シミュレータで確かめられます。Xcode の CarPlay ウィンドウを閉じると sceneDidDisconnect が呼ばれるため、再生中に閉じてから開き直す往復を、リリース前に必ず数回通しておくと安心です。審査でもこの流れを見られることがあります。

よくある落とし穴 — CarPlay 開発で詰まる 5 つのポイント

実際の開発で私が踏んだ、または相談を受けたトラブル 5 つを共有します。

1 つ目は「エンタイトルメントは取得できたが、Xcode のプロビジョニングプロファイルに CarPlay capability が付いていない」問題です。エンタイトルメント取得後、Apple Developer サイトの Identifier 設定で CarPlay capability を手動で有効化し、プロビジョニングプロファイルを再生成する必要があります。これを忘れると、ビルドは通るが CarPlay に表示されないという不可解な状態になります。

2 つ目は「CarPlay Simulator では動くが、実機で動かない」問題です。私の場合、原因はエンタイトルメントの入り方でした。開発用のプロビジョニングプロファイルには CarPlay capability が入っているのに、配布用のプロファイルを再生成しておらず、アーカイブしたビルドだけがエンタイトルメントなしで出ていたのです。ビルド後の .app に対して codesign -d --entitlements :- YourApp.app を実行し、カテゴリに応じたキーが実際に埋まっているかを目で確かめる習慣にしております。シミュレータは署名を見ないため、ここだけはどうしても抜け落ちます。

3 つ目は「iPhone 側で画面を閉じると、CarPlay 側のオーディオ再生も止まる」問題です。これは AVAudioSession のカテゴリを .playback に設定し、かつ UIBackgroundModes に audio を追加しないと発生します。

4 つ目は「CarPlay リストのスクロール位置が iPhone 側とずれる」問題です。両者は独立したシーンなので、スクロール位置を共有したい場合は App Group 経由で明示的に同期する必要があります。

5 つ目は「App Store 審査で『CarPlay のカテゴリ適合性が不十分』とリジェクトされる」問題です。審査官はエンタイトルメント申請時よりさらに厳しくカテゴリ適合性を見ます。TestFlight で Apple 社員が実際に車内でテストするケースもあるため、運転中の実用性を動画で示すなどの追加資料を用意しておくと通りやすくなります。

実践パターン — Rork で既存アプリに CarPlay 機能を追加する最短手順

ここまでの知識を、実際の Rork プロジェクトに適用する最短手順を示します。

まず Rork で作成済みの Expo プロジェクトを Xcode で開き、ios/YourApp/ 以下に CarPlaySceneDelegate.swift を新規作成します。Rork の AI に「CarPlay 用の CPListTemplate を実装する Swift コードを書いて」と指示するとベースコードを生成してくれますが、ここに CPTemplateApplicationSceneDelegate プロトコルの準拠と、先ほど示したライフサイクルメソッドを必ず含めるよう指示してください。

次に app.json にエンタイトルメントと App Group を追加し、expo prebuild --clean で iOS ネイティブプロジェクトを再生成します。Rork のクラウドビルドではなくローカルの Xcode でビルドすることで、エンタイトルメントの変更が反映されます。

最後に、Apple にエンタイトルメント申請を提出します。申請が通るまでは TestFlight にもビルドを上げられないため、先に申請を出してから実装を進めるのが時間効率的です。私の経験則では、エンタイトルメント申請と実装を並行で進めると、トータル 4〜6 週間で CarPlay 対応版をリリースできます。

リリース後は、CarPlay 対応アプリ特有のメトリクス（CarPlay 経由のセッション時間、連続再生時間、運転中のクラッシュ率）を App Store Connect で別途追跡すると改善ポイントが見えてきます。詳細な設計論は Rork で本格的な iOS アプリを構築する実践ガイド や Rork Max で App Store 審査を一発通過するノウハウ集 も参考にしてください。

リリース後の 30 日 — CarPlay を「別のアプリ」として計測する

CarPlay 対応は、出した瞬間がゴールではありません。むしろ最初のひと月で計測の土台を作れるかどうかが、その後の判断の精度を決めます。iPhone 側と同じ指標をまとめて見てしまうと、CarPlay の効果はほぼ確実に埋もれます。

経路を分けてイベントを送る

まず、CarPlay シーンから発火するイベントには必ず経路の属性を付けます。didConnect で接続フラグを立て、切断で元に戻します。これだけで、同じ「再生開始」イベントを車内と車外に切り分けられます。

final class CarPlaySessionTracker {
    static let shared = CarPlaySessionTracker()
    private(set) var isConnected = false
    private var connectedAt: Date?
 
    func markConnected() {
        isConnected = true
        connectedAt = Date()
    }
 
    func markDisconnected() {
        defer { isConnected = false; connectedAt = nil }
        guard let start = connectedAt else { return }
        Analytics.log("carplay_session_end", params: [
            "duration_sec": Int(Date().timeIntervalSince(start))
        ])
    }
 
    var surface: String { isConnected ? "carplay" : "phone" }
}

送信側では surface を全イベントの共通パラメータに載せます。後から分けようとすると過去分が復元できないため、ここは公開前に済ませておくのが確実です。

最初のひと月で見る 3 つの数字

見る指標は絞ったほうが判断できます。私は次の 3 つに限定しております。

1. CarPlay 経由の 1 セッションあたり連続利用時間。車内は中断が入りにくいため、iPhone 側より明確に長くなるはずです。ここが伸びていなければ、階層が深すぎて運転中に操作できていない可能性が高いです。
2. CarPlay を一度でも使った利用者の 7 日継続率と、使っていない利用者の 7 日継続率の差。在籍期間を揃えて比べます。CarPlay を投資として説明できるかどうかは、ほぼこの差で決まります。
3. CarPlay シーンで発生したクラッシュの件数。全体のクラッシュ率に混ぜず、単独で追います。

車内のクラッシュは重みが違う

3 つ目を分けている理由は、運転中の不具合が利用者に与える印象が、通常のクラッシュとは比べものにならないためです。画面を見られない状況で音が止まり、操作もできません。この体験は、そのままアンインストールにつながります。

私は CarPlay 由来のクラッシュだけは件数にかかわらず最優先で潰す運用にしております。頻度で優先度を決める通常のルールを、ここだけは適用しません。

最初の一歩 — カテゴリを 1 つ選んで、申請文を書いてみる

私は長いあいだ、CarPlay 対応を実装の問題だと思っておりました。いま思えば、詰まっていたのはいつも実装より前の部分でした。どのカテゴリで出すのかが決まらないまま手を動かしていたので、テンプレートの選び方も、審査で聞かれる観点も、そのたびに揺れていたのです。

ですから最初の一歩は、コードではなく Apple の CarPlay 開発者ページ を開くことをおすすめします。カテゴリ一覧から自分のアプリにいちばん近いものを 1 つだけ選び、「運転中の必然性」「安全性への配慮」「カテゴリ適合性」の 3 点を、500 字ほどで書いてみてください。書けたなら、実装は待っていてくれます。書けなかったなら、足りないのはコードではなく、運転中にしか生まれない価値のほうだと思います。

申請文が一段落で書けない機能は、まだ車内へ出す段階ではありません。 この線引きだけは、実装が先に動いてしまった日でも崩さないようにしております。

最後までお読みくださり、ありがとうございました。車内という文脈は、私にとってもまだ手探りの領域です。気づいたことがあれば、また書き残してまいります。