--- title: "Androidの開始手順" url: https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/setup-for-android/ description: "Androidをプライマリ開発ターゲットとしてFlutterモバイルアプリを構築するには、CatalystでAndroidアプリの開発に必要な環境をセットアップする必要があります。" 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/deployment-and-billing/environments/introduction/#introduction - name: "Android SDK" url: /ja/sdk/android/v2/overview/ --- # Androidの開始手順 Flutter SDKを使用してAndroidをプライマリ開発ターゲットとしてFlutterモバイルアプリケーションを構築するには、CatalystでAndroidアプリの開発に必要な環境をセットアップする必要があります。 ### 前提条件と最小サポート環境 Androidプラットフォームでのflutterアプリの作業を開始する前に、以下の前提条件を満たし、最小サポート環境を設定していることを確認してください： * [Android Studioまたはサポートされている任意のIDEでFlutterプロジェクトを作成](https://docs.flutter.dev/get-started/test-drive?tab=androidstudio)してください * Androidプロジェクトが以下の最小サポート環境を満たしていることを確認してください： * OS- Android API Level 21 (Lollipop 4.4) * Kotlin- 1.3.20 * Gradle- 3.4.0 * IDEでアプリを実行するためのデバイスまたはエミュレーターをセットアップしてください Catalystにアプリを登録し、アプリに合わせてカスタマイズされた設定ファイルをダウンロードできます。この設定ファイルには、アプリが正常に機能するために必要な特定のプロパティの定義が含まれているため、Androidアプリの構造に含める必要があります。 ## セットアップ FlutterおよびAndroidのセットアップの前提条件を満たした後、以下の手順に従ってAndroidパッケージをアプリにセットアップおよび統合してください。 ### ステップ1：CatalystにAndroidアプリを登録する まず、CatalystでAndroidアプリ用のパッケージを作成して登録し、固有の設定ファイルをダウンロードします。 1. プロジェクトのCatalystコンソールから設定アイコンをクリックします。 ![catalyst_console_settings](https://catalyst-docs-development.zohostratus.in/images/sdk/flutter/catalyst_console_settings.webp) 2. 設定メニューの*Project Settings*配下にある**Developer Tools**に移動し、**Android**タイルをクリックします。 ![developer_tools_android_sdk](https://catalyst-docs-development.zohostratus.in/images/sdk/flutter/dev_tools_android_sdk.webp)または、下の**Add Package**ボタンをクリックすることもできます。 3. 一意に識別できるパッケージ名を入力します。エンドユーザーがアプリにログインした後にリダイレクトするURLをRedirect URLとして指定します。 ![android_sdk_create_package](https://catalyst-docs-development.zohostratus.in/images/sdk/flutter/dev_tools_android_sdk_package_1.webp)ここで入力した値は、設定ファイルに自動入力されます。 > **Note**: パッケージ名はそのOSに一意に関連付けられます。そのため、AndroidアプリとiOSアプリの両方に同じ名前のパッケージを作成することはできません。一意の値を指定する必要があります。 OSタイプとしてAndroidが選択されていることを確認してください。 4. **Create**をクリックしてモバイルSDKパッケージを作成します。 5. コンソールに設定ファイルをダウンロードできるウィンドウが表示されます。**Download**をクリックしてファイルをダウンロードします。 ![android_sdk_package_successful](https://catalyst-docs-development.zohostratus.in/images/sdk/flutter/dev_tools_android_sdk_package_2.webp) 必要なすべての設定が含まれたファイルがダウンロードされます。このファイルのプロパティについては、次のステップで説明します。 ### ステップ2：AndroidプロジェクトにConfiguration Fileをインポートする Catalystは、アプリケーションの開発およびビルド用に、**Development**サンドボックスとライブの**Production**環境の2つの作業環境を提供しています。詳細については、[Environmentsヘルプページ](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction)を参照してください。 コンソールでパッケージを作成すると、現在作業している環境に関係なく、最初はDevelopment環境の設定ファイルのみがダウンロード可能になります。パッケージが作成された後であれば、いつでもコンソールから任意の環境の設定ファイルをダウンロードできます。 各環境の設定ファイル名は以下の通りです： * Development: `app_configuration_development.properties` * Production: `app_configuration_production.properties` 作業している環境に基づいて、適切なファイルをダウンロードしてAndroidアプリの構造に追加する必要があります。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)してください。 設定ファイルは、Androidアプリモジュールの`assets`ディレクトリに追加する必要があります。通常、`assets`フォルダは`app/src/main`ディレクトリに作成されます。 ![android_sdk_android_studs](https://catalyst-docs-development.zohostratus.in/images/sdk/android/android_sdk_android_studs.webp) Androidアプリモジュールの詳細については、[Android公式ドキュメント](https://developer.android.com/studio/projects)を参照してください。 #### app_configuration_development.properties/ app_configuration_production.propertiesファイルのプロパティ アプリ設定ファイルは、以下の表に記載されたプロパティを定義します。リクエストヘッダーを除くすべての値は、プロジェクトの詳細またはデフォルトの標準に基づいて自動的に入力されます。 > **Note**: これらの値の取得先については、表に記載されたリンクを参照してください。
プロパティ データ型 説明
`clientID` String Catalystに登録されたアプリクライアントの一意の識別子です。設定ファイルで提供されます。
`clientSecret` String 特定の`clientID`に対して生成されたシークレット値で、APIリクエストとともに渡されます。設定ファイルで提供されます。
`portalID` String 設定ファイルで提供される一意の識別子です
`redirectUrl` 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)）を使用してください。
`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`
`printStackTrace` Boolean `printStackTrace`の値が「**true**」に設定されている場合、ログの詳細なトレースを取得できます。デフォルト値は「**false**」です。
`minLogLevel` String アプリのログ設定を行えます 許容値：`warnings`、`errors`、`information`、`debug`、`ALL`
`httpRequestMode` String HTTPリクエストが同期か非同期かを定義します 許容値：`SYNC`、`ASYNC` デフォルト値：`ASYNC`
`connectTimeOut InSec` Long SDKから送信されるHTTPリクエストの接続タイムアウト値（秒単位）です つまり、この時間内にサーバーからクライアントリクエストへのレスポンスが受信されない場合、接続が終了します
`readTimeOutInSec` Long SDKから送信されるHTTPリクエストの読み取りタイムアウト値（秒単位）です つまり、この時間内にサーバーからデータが受信されない場合、接続が終了します
`writeTimeOutInSec` Long SDKから送信されるHTTPリクエストの書き込みタイムアウト値（秒単位）です つまり、この時間内にリクエストデータのサーバーへの書き込みまたは送信に失敗した場合、接続が終了します
`JWTClientID` String クライアントに渡されるサードパーティ認証用に生成されたカスタムサーバートークン（JSON Web Tokenトークン）のクライアントIDプロパティです
`JWTClientSecret` String クライアントに渡されるサードパーティ認証用に生成されたカスタムサーバートークン（JSON Web Tokenトークン）のクライアントシークレットプロパティです
> **Note**: * 設定ファイルの`clientID`、`clientSecret`、`projectID`、または`portalID`の値を変更すると、SDKおよびAndroidアプリの機能に影響します。これらの設定を変更する場合は、Developer Toolsセクションから必要なプロジェクトの[新しいパッケージを作成](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/developer-tools/#create-a-mobile-sdk-package)し、適切な環境の新しい設定ファイルをダウンロードして、アプリの構造の`assets`ディレクトリに追加してください。 * ダウンロードした設定ファイルに入力されたプロパティの値は、`ZCatalystApp.configs`オブジェクトを使用して動的にアクセスできます。 ### ステップ3：アプリのログインリダイレクトを設定する ユーザーがアプリに正常にログインすると、アプリのホーム画面にリダイレクトされます。このユーザーログインとリダイレクトは、Catalyst SDKによって処理されます。 このリダイレクトが正しく処理されるようにするには、以下のURLスキーマをAndroidアプリの`strings.xml`ファイルに含めてください： ```bash <string name="url_scheme">{redirection_url}</string> ``` `strings.xml`ファイルは、Androidプロジェクトを作成すると自動的に作成されます。アプリの構造で`app/src/main/res/values`に移動すると見つけることができます。ファイルにはアプリ名の文字列定義が既に含まれています。この文字列をそれに追加してください。 Catalystでアプリの[パッケージを作成](https://docs.catalyst.zoho.com/ja/sdk/android/v2/setup/#step-1-register-your-android-app-with-catalyst)する際に設定した**Redirection URL**を、このコードの`redirection_url`の代わりに渡す必要があります。 ### ステップ4：必要な権限を設定する Catalyst SDKは、アプリがシームレスに機能し、スムーズなユーザーエクスペリエンスを提供するために、以下のアプリ権限を有効にする必要があります： * `INTERNET`: Catalyst APIを実行するため * `ACCESS_NETWORK_STATE`: ネットワーク障害を処理するため これらの権限を有効にするには、以下に示すように`AndroidManifest.xml`ファイルで宣言する必要があります： ```bash <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <uses-permission android:name="android.permission.INTERNET"/> ``` `AndroidManifest.xml`ファイルは、アプリの構造で`app/src/main`に移動すると見つけることができます。 Androidをプライマリ開発ターゲットとしたFlutterアプリの構築のセットアップが完了しました。これで、[アプリへのCatalyst Flutter SDKの実装](https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/implement-flutter-sdk/)に進むことができます。