iOSの開始手順

# iOSの開始手順

Flutter SDKを使用してiOSをプライマリ開発ターゲットとしてFlutterモバイルアプリケーションを構築するには、CatalystでiOSアプリの開発に必要な環境をセットアップする必要があります。

### 前提条件と最小サポート環境

iOSプラットフォームでのFlutterアプリの作業を開始する前に、以下の前提条件を満たし、最小サポート環境を設定していることを確認してください：

* {{%link href="https://docs.flutter.dev/get-started/test-drive?tab=vscode"%}}サポートされている任意のIDEまたはターミナルからFlutterプロジェクトを作成{{%/link%}}してください

* iOSプロジェクトが以下の最小サポート環境を満たしていることを確認してください：
    * {{%link href="https://guides.cocoapods.org/"%}}CocoaPods{{%/link%}}
    * iOS- 9以降
    * Swift- 4以降

* IDEでアプリを実行するためのデバイスまたはエミュレーターをセットアップしてください

Catalystにアプリを登録し、アプリに合わせてカスタマイズされた設定ファイルをダウンロードできます。この設定ファイルには、アプリが正常に機能するために必要な特定のプロパティの定義が含まれているため、iOSアプリの構造に含める必要があります。

<br>

## セットアップ

Catalystプロジェクトとiosプロジェクトを作成した後、以下の手順に従ってiOS SDKパッケージをアプリにセットアップおよび統合してください。

### ステップ1：CatalystにiOSアプリを登録する

まず、CatalystでiOSアプリ用のパッケージを作成して登録し、固有の設定ファイルをダウンロードします。

1. プロジェクトのCatalystコンソールから**設定アイコン**をクリックします。

2. 設定メニューの{{%italics%}}Project Settings{{%/italics%}}配下にある**Developer Tools**に移動し、**iOS**タイルをクリックします。

または、下の**Add Package**ボタンをクリックすることもできます。

3. 一意に識別できるパッケージ名を入力します。エンドユーザーがアプリにログインした後にリダイレクトするURLをRedirect URLとして指定します。

ここで入力した値は、設定ファイルに自動入力されます。

{{%note%}} {{%bold class="bold-primary"%}}Note{{%/bold%}}: パッケージ名はそのOSに一意に関連付けられます。そのため、AndroidアプリとiOSアプリの両方に同じ名前のパッケージを作成することはできません。一意の値を指定する必要があります。{{%/note%}}

OSタイプとしてiOSが選択されていることを確認してください。

4. **Create**をクリックしてモバイルSDKパッケージを作成します。

5. コンソールに設定ファイルをダウンロードできるウィンドウが表示されます。**Download**をクリックしてファイルをダウンロードします。

必要なすべての設定が含まれたファイルがダウンロードされます。このファイルのプロパティについては、次のステップで説明します。

<br>

### ステップ2：iOSプロジェクトにConfiguration Fileをインポートする

Catalystは、アプリケーションの開発およびビルド用に、**Development**サンドボックスとライブの**Production**環境の2つの作業環境を提供しています。詳細については、{{%link href="/ja/deployment-and-billing/environments/introduction"%}}Environmentsヘルプページ{{%/link%}}を参照してください。

コンソールでパッケージを作成すると、現在作業している環境に関係なく、最初はDevelopment環境の設定ファイルのみがダウンロード可能になります。パッケージが作成された後であれば、いつでもコンソールから任意の環境の設定ファイルをダウンロードできます。

各環境の設定ファイル名は以下の通りです：

* Development: {{%badge%}}**AppConfigurationDevelopment.plist**{{%/badge%}}
* Production: {{%badge%}}**AppConfigurationProduction.plist**{{%/badge%}}

作業している環境に基づいて、適切なファイルをダウンロードしてiOSプロジェクトの**Targets** -> **Runner**に追加する必要があります。Production環境の設定ファイルを取得するには、まず{{%link href="/ja/deployment-and-billing/environments/initial-deployment"%}}プロジェクトをProductionにデプロイ{{%/link%}}してから、{{%italics%}}Developer Tools{{%/italics%}}設定セクションから{{%link href="/ja/getting-started/set-up-a-catalyst-project/developer-tools"%}}ファイルをダウンロード{{%/link%}}してください。

設定ファイルは、iOSプロジェクトの**Targets** -> **Runner**に追加する必要があります。

iOSプロジェクト構造の詳細については、{{%link href="https://developer.apple.com/documentation/"%}}iOS公式ドキュメント{{%/link%}}を参照してください。

#### AppConfigurationDevelopment.plist/ AppConfigurationProduction.plistファイルのプロパティ

アプリ設定ファイルは、以下の表に記載されたプロパティを定義します。リクエストヘッダーを除くすべての値は、プロジェクトの詳細またはデフォルトの標準に基づいて自動的に入力されます。

{{%note%}} {{%bold class="bold-primary"%}}Note{{%/bold%}}: これらの値の取得先については、表に記載されたリンクを参照してください。{{%/note%}}

<table class="content-table">
<thead>
<tr>
<th class="w20p">プロパティ</th>
<th class="w20p">データ型</th>
<th class="w20p">説明</th>
</tr>
</thead>
<tbody>
<tr> 
<td>{{%badge%}}**ClientID**{{%/badge%}}</td>
<td>String</td>
<td>Catalystに登録されたアプリクライアントの一意の識別子です。設定ファイルで提供されます。</td>
</tr>

<tr> 
<td>{{%badge%}}**ClientSecretID**{{%/badge%}}</td>
<td>String</td>
<td>特定の{{%badge%}}clientID{{%/badge%}}に対して生成されたシークレット値で、APIリクエストとともに渡されます。設定ファイルで提供されます。</td>
</tr>

<tr> 
<td>{{%badge%}}**PortalID**{{%/badge%}}</td>
<td>String</td>
<td>設定ファイルで提供される一意の識別子です</td>
</tr>
<tr> 
<td>{{%badge%}}**RedirectURLScheme**{{%/badge%}}</td>
<td>String</td>
<td>前のステップでコンソールでパッケージを作成する際に指定した、アプリのコールバックURLです</td>
</tr>
<tr> 
<td>{{%badge%}}**ProjectID**{{%/badge%}}</td>
<td>Long</td>
<td>Catalystプロジェクトの{{%link href="/ja/getting-started/set-up-a-catalyst-project/general-settings/" %}}一意のID{{%/link%}}です</td>
</tr> 
<tr>
<td>{{%badge%}}**APIBaseURL**{{%/badge%}}</td>
<td>String</td>
<td>内部APIが呼び出されるCatalystサーバーのURLです。作業している環境に基づいて、適切なURL（{{%link href="/ja/deployment-and-billing/environments/development-environment/#function-url-and-web-app-url-in-the-development-environment"%}}Development URL{{%/link%}}または{{%link href="/ja/deployment-and-billing/environments/production-environment/#function-url-and-web-app-url-in-the-production-environment"%}}Production URL{{%/link%}}）を使用してください。</td>
</tr>
<tr>
<td>{{%badge%}}**APIVersion**{{%/badge%}}</td>
<td>String</td>
<td>APIのバージョンです</td>
</tr>
<tr>
<td>{{%badge%}}**OauthScopes**{{%/badge%}}</td>
<td>String</td>
<td>プロジェクトからCatalyst APIにアクセスするためにアプリが使用するスコープです。利用可能なOAuthスコープは{{%link href="/ja/api/oauth2/scopes/#Scopes" %}}こちら{{%/link%}}で確認できます。</td>
</tr>
<tr>
<td>{{%badge%}}**RequestHeaders**{{%/badge%}}</td>
<td>String</td>
<td>HTTPリクエストでクライアントが送信するヘッダーです<br /> リクエストヘッダーの値は、コンマで区切られた個別のキーバリューペアで指定する必要があります：{{%badge%}}requestHeaders={{%/badge%}}{{%italics%}}key1:value1, key2:value2{{%/italics%}}</td>
</tr>
<tr>
<td>{{%badge%}}**ServerTLD**{{%/badge%}}</td>
<td>String</td>
<td>データサーバーのトップレベルドメインです<br /> 許容値：{{%badge%}}**AU**{{%/badge%}}、{{%badge%}}**CN**{{%/badge%}}、{{%badge%}}**COM**{{%/badge%}}、{{%badge%}}**EU**{{%/badge%}}、{{%badge%}}**IN**{{%/badge%}}</td>
</tr>
<tr>
<td>{{%badge%}}**MinLogLevel**{{%/badge%}}</td>
<td>String</td>
<td>アプリのログ設定を行えます<br /> 許容値：{{%badge%}}**warnings**{{%/badge%}}、{{%badge%}}**errors**{{%/badge%}}、{{%badge%}}**information**{{%/badge%}}、{{%badge%}}**debug**{{%/badge%}}、{{%badge%}}**ALL**{{%/badge%}}</td>
</tr>
<tr>
<td>{{%badge%}}**TurnLoggerOn**{{%/badge%}}</td>
<td>Boolean</td>
<td>値に基づいてロガーをオンにします<br /> 許容値：{{%badge%}}**true**{{%/badge%}}、{{%badge%}}**false**{{%/badge%}}</td>
</tr>
<tr>
<td>{{%badge%}}**RequestTimeOut**{{%/badge%}}</td>
<td>Double</td>
<td>追加データの到着を待機してからタイムアウトするまでの時間（秒単位）です</td>
</tr>
<tr>
<td>{{%badge%}}**JWTClientID**{{%/badge%}}</td>
<td>String</td>
<td>クライアントに渡されるサードパーティ認証用に生成されたカスタムサーバートークン（JSON Web Tokenトークン）のクライアントIDプロパティです</td>
</tr>
<tr>
<td>{{%badge%}}**JWTClientSecret**{{%/badge%}}</td>
<td>String</td>
<td>クライアントに渡されるサードパーティ認証用に生成されたカスタムサーバートークン（JSON Web Tokenトークン）のクライアントシークレットプロパティです</td>
</tr>
</tbody>
</table>

{{%note%}}{{%bold%}}Note{{%/bold%}}:<br />

* 設定ファイルの{{%badge%}}**clientID**{{%/badge%}}、{{%badge%}}**clientSecretID**{{%/badge%}}、{{%badge%}}**projectID**{{%/badge%}}、または{{%badge%}}**portalID**{{%/badge%}}の値を変更すると、SDKおよびiOSアプリの機能に影響します。これらの設定を変更する場合は、Developer Toolsセクションから必要なプロジェクトの{{%link href="/ja/getting-started/set-up-a-catalyst-project/developer-tools/#create-a-mobile-sdk-package"%}}新しいパッケージを作成{{%/link%}}し、適切な環境の新しい設定ファイルをダウンロードして、iOSプロジェクトに追加してください。

* ダウンロードした設定ファイルに入力されたプロパティの値は、{{%badge%}}**ZCatalystApp.configs**{{%/badge%}}オブジェクトを使用して動的にアクセスできます。{{%/note%}}

<br>

### ステップ3：アプリのログインリダイレクトを設定する

ユーザーがアプリに正常にログインすると、アプリのホーム画面にリダイレクトされます。このユーザーログインとリダイレクトは、Catalyst SDKによって処理されます。

このリダイレクトが正しく処理されるようにするには、以下のキーを同じ設定でiOSプロジェクトの{{%badge%}}**info.plist**{{%/badge%}}ファイルに含めてください：

{{%note%}}Key - {{%badge%}}**URL Types**{{%/badge%}} -----> {{%badge%}}**URL Schemes**{{%/badge%}}<br />
Type - String<br />
Value - Catalystでアプリの{{%link href="/ja/sdk/ios/v2/setup/#register-your-iOS-app-with-catalyst"%}}パッケージを作成{{%/link%}}する際に設定したRedirect URL
{{%/note%}}

<br>

iOSをプライマリ開発ターゲットとしたFlutterアプリの構築のセットアップが完了しました。これで、{{%link href="/ja/sdk/flutter/v2/implement-flutter-sdk/" %}}アプリへのCatalyst Flutter SDKの実装{{%/link%}}に進むことができます。

前提条件と最小サポート環境

iOSプラットフォームでのFlutterアプリの作業を開始する前に、以下の前提条件を満たし、最小サポート環境を設定していることを確認してください：

サポートされている任意のIDEまたはターミナルからFlutterプロジェクトを作成してください
iOSプロジェクトが以下の最小サポート環境を満たしていることを確認してください：
- CocoaPods
- iOS- 9以降
- Swift- 4以降
IDEでアプリを実行するためのデバイスまたはエミュレーターをセットアップしてください

セットアップ

Catalystプロジェクトとiosプロジェクトを作成した後、以下の手順に従ってiOS SDKパッケージをアプリにセットアップおよび統合してください。

ステップ1：CatalystにiOSアプリを登録する

まず、CatalystでiOSアプリ用のパッケージを作成して登録し、固有の設定ファイルをダウンロードします。

プロジェクトのCatalystコンソールから設定アイコンをクリックします。
設定メニューのProject Settings配下にあるDeveloper Toolsに移動し、iOSタイルをクリックします。または、下のAdd Packageボタンをクリックすることもできます。
一意に識別できるパッケージ名を入力します。エンドユーザーがアプリにログインした後にリダイレクトするURLをRedirect URLとして指定します。ここで入力した値は、設定ファイルに自動入力されます。

Note: パッケージ名はそのOSに一意に関連付けられます。そのため、AndroidアプリとiOSアプリの両方に同じ名前のパッケージを作成することはできません。一意の値を指定する必要があります。

OSタイプとしてiOSが選択されていることを確認してください。

CreateをクリックしてモバイルSDKパッケージを作成します。
コンソールに設定ファイルをダウンロードできるウィンドウが表示されます。Downloadをクリックしてファイルをダウンロードします。

必要なすべての設定が含まれたファイルがダウンロードされます。このファイルのプロパティについては、次のステップで説明します。

ステップ2：iOSプロジェクトにConfiguration Fileをインポートする

Catalystは、アプリケーションの開発およびビルド用に、DevelopmentサンドボックスとライブのProduction環境の2つの作業環境を提供しています。詳細については、Environmentsヘルプページを参照してください。

各環境の設定ファイル名は以下の通りです：

Development: AppConfigurationDevelopment.plist
Production: AppConfigurationProduction.plist

作業している環境に基づいて、適切なファイルをダウンロードしてiOSプロジェクトのTargets -> Runnerに追加する必要があります。Production環境の設定ファイルを取得するには、まずプロジェクトをProductionにデプロイしてから、Developer Tools設定セクションからファイルをダウンロードしてください。

設定ファイルは、iOSプロジェクトのTargets -> Runnerに追加する必要があります。

iOSプロジェクト構造の詳細については、iOS公式ドキュメントを参照してください。

AppConfigurationDevelopment.plist/ AppConfigurationProduction.plistファイルのプロパティ

Note: これらの値の取得先については、表に記載されたリンクを参照してください。

プロパティ	データ型	説明
ClientID	String	Catalystに登録されたアプリクライアントの一意の識別子です。設定ファイルで提供されます。
ClientSecretID	String	特定のclientIDに対して生成されたシークレット値で、APIリクエストとともに渡されます。設定ファイルで提供されます。
PortalID	String	設定ファイルで提供される一意の識別子です
RedirectURLScheme	String	前のステップでコンソールでパッケージを作成する際に指定した、アプリのコールバックURLです
ProjectID	Long	Catalystプロジェクトの一意のIDです
APIBaseURL	String	内部APIが呼び出されるCatalystサーバーのURLです。作業している環境に基づいて、適切なURL（Development URLまたはProduction URL）を使用してください。
APIVersion	String	APIのバージョンです
OauthScopes	String	プロジェクトからCatalyst APIにアクセスするためにアプリが使用するスコープです。利用可能なOAuthスコープはこちらで確認できます。
RequestHeaders	String	HTTPリクエストでクライアントが送信するヘッダーですリクエストヘッダーの値は、コンマで区切られた個別のキーバリューペアで指定する必要があります：requestHeaders=key1:value1, key2:value2
ServerTLD	String	データサーバーのトップレベルドメインです許容値：AU、CN、COM、EU、IN
MinLogLevel	String	アプリのログ設定を行えます許容値：warnings、errors、information、debug、ALL
TurnLoggerOn	Boolean	値に基づいてロガーをオンにします許容値：true、false
RequestTimeOut	Double	追加データの到着を待機してからタイムアウトするまでの時間（秒単位）です
JWTClientID	String	クライアントに渡されるサードパーティ認証用に生成されたカスタムサーバートークン（JSON Web Tokenトークン）のクライアントIDプロパティです
JWTClientSecret	String	クライアントに渡されるサードパーティ認証用に生成されたカスタムサーバートークン（JSON Web Tokenトークン）のクライアントシークレットプロパティです

Note:

設定ファイルのclientID、clientSecretID、projectID、またはportalIDの値を変更すると、SDKおよびiOSアプリの機能に影響します。これらの設定を変更する場合は、Developer Toolsセクションから必要なプロジェクトの新しいパッケージを作成し、適切な環境の新しい設定ファイルをダウンロードして、iOSプロジェクトに追加してください。
ダウンロードした設定ファイルに入力されたプロパティの値は、ZCatalystApp.configsオブジェクトを使用して動的にアクセスできます。

ステップ3：アプリのログインリダイレクトを設定する

このリダイレクトが正しく処理されるようにするには、以下のキーを同じ設定でiOSプロジェクトのinfo.plistファイルに含めてください：

Key - URL Types -----> URL Schemes
Type - String
Value - Catalystでアプリのパッケージを作成する際に設定したRedirect URL

iOSをプライマリ開発ターゲットとしたFlutterアプリの構築のセットアップが完了しました。これで、アプリへのCatalyst Flutter SDKの実装に進むことができます。

最終更新日 2026-02-23 18:09:41 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Environments Developer Tools iOS SDK