--- title: "セットアップ" url: https://docs.catalyst.zoho.com/ja/sdk/ios/v2/setup/ description: "CatalystプロジェクトとiOSプロジェクトをセットアップするための手順。" last_updated: 2026-08-17T12:16:04Z service: All Services type: general related_links: - name: "Developer Tools" url: /ja/getting-started/set-up-a-catalyst-project/developer-tools --- # セットアップ CatalystプロジェクトとiOSプロジェクトを作成した後、以下の手順に従ってiOS SDKパッケージをアプリにセットアップおよび統合する必要があります。 ### Step 1: iOSアプリをCatalystに登録する まず、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) 必要なすべての設定が含まれたファイルがダウンロードされます。このファイルのプロパティについては、次のステップで説明します。 ### Step 2: iOSプロジェクトに設定ファイルをインポートする Catalystは、アプリケーションを開発・構築するために、**Development**サンドボックスとライブの**Production**環境の2つの作業環境を提供しています。詳細については、[環境のヘルプページ](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 追加データの到着を待機してからタイムアウトするまでの時間（秒単位）です
`X-Catalyst-Environment` String 設定ファイルがダウンロードされた環境（DevelopmentまたはProduction）です
`X-CATALYST-USER` String アプリユーザーのユーザーロールです
`AccountsPortalDomain` String Zohoアカウントのポータルドメインです
`notificationAppID` String iOSアプリの[Push Notifications](https://docs.catalyst.zoho.com/ja/cloud-scale/help/push-notifications/ios/#configure-and-enroll-for-ios-push-notifications)に登録した後にCatalystによって生成されるIDです
`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`オブジェクトを使用して動的にアクセスできます。 ### Step 3: アプリにCatalyst iOS SDKを追加する 次のステップは、SDKパッケージをアプリに含めることです。[CocoaPods](https://guides.cocoapods.org/)を使用してCatalyst SDKライブラリをインストールできます。 新規または既存のプロジェクトにCatalyst iOS SDKを依存関係として追加するには: 1. プロジェクトの**Podfile**のアプリのターゲットの下に、以下のコードスニペットを挿入します: ```bash pod 'ZCatalyst', :git =>'https://github.com/zoho/Catalyst-iOS-SDK.git', :tag => '2.2.2' ``` 2. システムのターミナルから`pod install`コマンドを実行します。 これによりPodがインストールされ、Catalyst iOS SDKがiOSアプリに追加されます。 ### Step 4: アプリのログインリダイレクトを設定する ユーザーがアプリに正常にログインすると、アプリのホーム画面にリダイレクトされます。このユーザーログインとリダイレクトは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) ### Step 5: SDKを初期化する SDKパッケージで定義されたメソッドと機能を有効にするために、Catalyst SDKを初期化する必要があります。 したがって、SDKメソッドを使用するようにアプリを設定する前に、以下の方法でSDKを初期化する必要があります: ```bash public func initSDK( window : UIWindow, environment : ZCatalystEnvironment, appConfiguration : ZCatalystAppConfiguration ) throws ``` **パラメータ:** * `window`: ビューにイベントをディスパッチするウィンドウオブジェクト * `environment`: アプリの環境。`.development`または`.production`のいずれかです。 * `appConfiguration`: SDKの機能に必要なすべての設定詳細を含むオブジェクト ここでの`environment`は、アプリが[DevelopmentまたはProduction](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction)環境で動作しているかを示します。環境に基づいて適切なplist設定ファイルをアプリのプロジェクトに含めるのと同様に、適切な環境でSDKを初期化する必要があります。 > **Note**: * `AppConfigurationDevelopment.plist`または`AppConfigurationProduction.plist`ファイルに変更を加えた場合、SDKを再初期化する必要があります。 * iOSアプリにサードパーティ認証を設定した場合、この設定ファイルに新しいプロパティが追加されるため、SDKの再初期化も必要です。詳細については、[こちらのヘルプページ](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/authentication/third-party-authentication/)をご覧ください。 SDKが正常に初期化されると、アプリはコンポーネントメソッドを呼び出し、意図した通りに機能します。 ### Step 6: アプリケーション画面へのリダイレクトを設定する iOSアプリに設定したログインページが別のドメインからのものである場合、アプリケーション画面へのリダイレクトを設定できます。ログインに成功すると、アプリケーションレイヤーにリダイレクトされます。 `UIApplication`インスタンスのコードは以下の通りです: ```bash ZCatalystApp.shared.handleLoginRedirection( _ url : URL, sourceApplication : String?, annotation : Any ) AppDelegate.swift ``` **パラメータ:** * `url`: ログイン成功後に開くURLリソース * `sourceApplication`: URLを開くことを要求しているアプリのバンドルID * `annotation`: アプリがURLとともに送信する追加データ `UIScene`インスタンスのコードは以下の通りです: ```bash func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) { if let context = URLContexts.first { ZCatalystApp.shared.handleLoginRedirection(context.url, sourceApplication: context.options.sourceApplication, annotation: context.options.annotation as Any) } } ``` セットアップは完了です。Catalyst iOS SDKを使用してiOSアプリを構築できます。