--- title: "iOSの開始手順" url: https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/setup-for-ios/ description: "iOSをプライマリ開発ターゲットとしてFlutterモバイルアプリを構築するには、CatalystでiOSアプリの開発に必要な環境をセットアップする必要があります。" last_updated: 2026-08-17T12:16:04Z service: All Services type: general related_links: - name: "Environments" url: /ja/deployment-and-billing/environments/introduction/#introduction - name: "Developer Tools" url: /ja/getting-started/set-up-a-catalyst-project/developer-tools - name: "iOS SDK" url: /ja/sdk/ios/v2/overview/ --- # iOSの開始手順 Flutter SDKを使用してiOSをプライマリ開発ターゲットとしてFlutterモバイルアプリケーションを構築するには、CatalystでiOSアプリの開発に必要な環境をセットアップする必要があります。 ### 前提条件と最小サポート環境 iOSプラットフォームでのFlutterアプリの作業を開始する前に、以下の前提条件を満たし、最小サポート環境を設定していることを確認してください： * [サポートされている任意のIDEまたはターミナルからFlutterプロジェクトを作成](https://docs.flutter.dev/get-started/test-drive?tab=vscode)してください * iOSプロジェクトが以下の最小サポート環境を満たしていることを確認してください： * [CocoaPods](https://guides.cocoapods.org/) * iOS- 9以降 * Swift- 4以降 * IDEでアプリを実行するためのデバイスまたはエミュレーターをセットアップしてください Catalystにアプリを登録し、アプリに合わせてカスタマイズされた設定ファイルをダウンロードできます。この設定ファイルには、アプリが正常に機能するために必要な特定のプロパティの定義が含まれているため、iOSアプリの構造に含める必要があります。 ## セットアップ Catalystプロジェクトとiosプロジェクトを作成した後、以下の手順に従ってiOS SDKパッケージをアプリにセットアップおよび統合してください。 ### ステップ1：CatalystにiOSアプリを登録する まず、CatalystでiOSアプリ用のパッケージを作成して登録し、固有の設定ファイルをダウンロードします。 1. プロジェクトのCatalystコンソールから**設定アイコン**をクリックします。 ![catalyst_sdk_android_settings_icon](https://catalyst-docs-development.zohostratus.in/images/sdk/flutter/catalyst_console_settings.webp) 2. 設定メニューの*Project Settings*配下にある**Developer Tools**に移動し、**iOS**タイルをクリックします。 ![ios_sdk_all_package](https://catalyst-docs-development.zohostratus.in/images/sdk/flutter/dev_tools_ios_sdk.webp) または、下の**Add Package**ボタンをクリックすることもできます。 3. 一意に識別できるパッケージ名を入力します。エンドユーザーがアプリにログインした後にリダイレクトするURLをRedirect URLとして指定します。 ![ios_sdk_create_package](https://catalyst-docs-development.zohostratus.in/images/sdk/flutter/dev_tools_ios_sdk_package_1.webp) ここで入力した値は、設定ファイルに自動入力されます。 > **Note**: パッケージ名はそのOSに一意に関連付けられます。そのため、AndroidアプリとiOSアプリの両方に同じ名前のパッケージを作成することはできません。一意の値を指定する必要があります。 OSタイプとしてiOSが選択されていることを確認してください。 4. **Create**をクリックしてモバイルSDKパッケージを作成します。 5. コンソールに設定ファイルをダウンロードできるウィンドウが表示されます。**Download**をクリックしてファイルをダウンロードします。 ![ios_sdk_package_created](https://catalyst-docs-development.zohostratus.in/images/sdk/flutter/dev_tools_ios_sdk_package_2.webp) 必要なすべての設定が含まれたファイルがダウンロードされます。このファイルのプロパティについては、次のステップで説明します。 ### ステップ2：iOSプロジェクトにConfiguration Fileをインポートする Catalystは、アプリケーションの開発およびビルド用に、**Development**サンドボックスとライブの**Production**環境の2つの作業環境を提供しています。詳細については、[Environmentsヘルプページ](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction)を参照してください。 コンソールでパッケージを作成すると、現在作業している環境に関係なく、最初はDevelopment環境の設定ファイルのみがダウンロード可能になります。パッケージが作成された後であれば、いつでもコンソールから任意の環境の設定ファイルをダウンロードできます。 各環境の設定ファイル名は以下の通りです： * Development: `AppConfigurationDevelopment.plist` * Production: `AppConfigurationProduction.plist` 作業している環境に基づいて、適切なファイルをダウンロードしてiOSプロジェクトの**Targets** -> **Runner**に追加する必要があります。Production環境の設定ファイルを取得するには、まず[プロジェクトをProductionにデプロイ](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/initial-deployment)してから、*Developer Tools*設定セクションから[ファイルをダウンロード](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/developer-tools)してください。 設定ファイルは、iOSプロジェクトの**Targets** -> **Runner**に追加する必要があります。 ![catalyst_sdk_ios_properties_file](https://catalyst-docs-development.zohostratus.in/images/sdk/ios/catalyst_sdk_ios_properties_file.webp) iOSプロジェクト構造の詳細については、[iOS公式ドキュメント](https://developer.apple.com/documentation/)を参照してください。 #### AppConfigurationDevelopment.plist/ AppConfigurationProduction.plistファイルのプロパティ アプリ設定ファイルは、以下の表に記載されたプロパティを定義します。リクエストヘッダーを除くすべての値は、プロジェクトの詳細またはデフォルトの標準に基づいて自動的に入力されます。 > **Note**: これらの値の取得先については、表に記載されたリンクを参照してください。
プロパティ データ型 説明
`ClientID` String Catalystに登録されたアプリクライアントの一意の識別子です。設定ファイルで提供されます。
`ClientSecretID` String 特定の`clientID`に対して生成されたシークレット値で、APIリクエストとともに渡されます。設定ファイルで提供されます。
`PortalID` String 設定ファイルで提供される一意の識別子です
`RedirectURLScheme` String 前のステップでコンソールでパッケージを作成する際に指定した、アプリのコールバックURLです
`ProjectID` Long Catalystプロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)です
`APIBaseURL` String 内部APIが呼び出されるCatalystサーバーのURLです。作業している環境に基づいて、適切なURL（[Development URL](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/#function-url-and-web-app-url-in-the-development-environment)または[Production URL](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/production-environment/#function-url-and-web-app-url-in-the-production-environment)）を使用してください。
`APIVersion` String APIのバージョンです
`OauthScopes` String プロジェクトからCatalyst APIにアクセスするためにアプリが使用するスコープです。利用可能なOAuthスコープは[こちら](https://docs.catalyst.zoho.com/ja/api/oauth2/scopes/#Scopes)で確認できます。
`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セクションから必要なプロジェクトの[新しいパッケージを作成](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/developer-tools/#create-a-mobile-sdk-package)し、適切な環境の新しい設定ファイルをダウンロードして、iOSプロジェクトに追加してください。 * ダウンロードした設定ファイルに入力されたプロパティの値は、`ZCatalystApp.configs`オブジェクトを使用して動的にアクセスできます。 ### ステップ3：アプリのログインリダイレクトを設定する ユーザーがアプリに正常にログインすると、アプリのホーム画面にリダイレクトされます。このユーザーログインとリダイレクトは、Catalyst SDKによって処理されます。 このリダイレクトが正しく処理されるようにするには、以下のキーを同じ設定でiOSプロジェクトの`info.plist`ファイルに含めてください： > Key - `URL Types` -----> `URL Schemes` Type - String Value - Catalystでアプリの[パッケージを作成](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/setup/#register-your-iOS-app-with-catalyst)する際に設定したRedirect URL ![catalyst_sdk_ios_info_plist](https://catalyst-docs-development.zohostratus.in/images/sdk/ios/catalyst_sdk_ios_info_plist.webp) iOSをプライマリ開発ターゲットとしたFlutterアプリの構築のセットアップが完了しました。これで、[アプリへのCatalyst Flutter SDKの実装](https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/implement-flutter-sdk/)に進むことができます。