このヘルプページは Creator 6 をご利用のユーザー向けです。旧バージョン(Creator 5)をご利用の場合は、こちらをクリックしてください。ご利用中のCreator のバージョンを確認してください。
Zoho Creator の Android SDK のコアライブラリを使用すると、 カスタム UI を作成し、Creator アプリケーション内のデータを利用して Android アプリ を構築できます。
前提条件
- 最新バージョンの Android Studio
Android アプリを Zoho に登録する
- 左側のペインで モバイル をクリックします。
-
コアフレームワークを設定したい Android アプリの対象行をクリックします。右側に ユーザー用 - SDK ペインが表示されます。

-
クライアントを生成 をクリックします。

-
これにより、Creator アプリケーションと連携させたい Android アプリ用の クライアント ID、クライアントシークレット、redirectURI が生成されます。

- zcapp_info.properties ファイルをダウンロードし、プロジェクトの raw フォルダー '<your_project_folder>/app/src/main/res/raw' に追加します。(存在しない場合は、この場所に raw という名前のフォルダーを作成してください)
Kotlin を使用してユーザー用アプリに Android コアライブラリをインストールする
メモ:Android アプリの最小 SDK バージョンは 22 以上である必要があります。
-
Android アプリに SDK を連携するには:
-
app/build.gradle に Zoho の Maven リポジトリ URL を追加します:
-
app/build.gradle に Zoho Creator Core ライブラリと Authentication ライブラリを追加します。
- IDE に表示されるバーで 今すぐ同期する をクリックします。
-
-
次のコードを使用してプロジェクトを設定します:
-
アプリの strings。xml に、次の文字列を追加します:
-
アプリケーション/アクティビティクラスの onCreate メソッド内で、次のように Accounts SDK を初期化します:
ZohoSDK.getInstance(this).init(scopes, showlogs);ここで、
-
scopes - 'aaaserver。権限。READ,zohocontacts。userphoto。READ,ZohoContacts。contactapi。READ,
ZohoCreator。meta。作成,ZohoCreator。meta。READ,ZohoCreator。meta。更新する,
ZohoCreator。meta。削除,ZohoCreator。data。作成,ZohoCreator。data。READ,
ZohoCreator。data。更新する,ZohoCreator。data。削除,Stratus。stratusop。READ,
ZohoCRM。タブ。READ,ZohoCRM。ユーザー。READ' - showLogs - デバッグログを表示するかどうかを指定します。
-
-
HandleRedirectActivity というアクティビティを作成し、その onCreate メソッドに次のコードを追加します:
ZohoSDK.getInstance(this).handleRedirection(this); -
AndroidManifest。xml ファイルに次のコードを追加します:
-
ログイン画面を開くには、次のコードスニペットを追加します:
val sdk = ZohoSDK.getInstance(applicationContext) if (!sdk.isUserSignedIn) { sdk.presentLoginScreen(this, object : ZohoTokenCallback { override fun onTokenFetchInitiated() { } override fun onTokenFetchComplete(zohoToken: ZohoToken?) { // This method will be called after user logged-in successfully } override fun onTokenFetchFailed(zohoErrorCodes: ZohoErrorCodes?) { // This method will be called if any error occurred in the login. You will receive the error code in this callback. } }, null) } else { // Start intent to your first activity } -
Creator 認証インターフェイス ZCOauthHelper を次のように実装します:
クラス ZCAuthImpl(非公開 val context: Context) : ZCOauthHelper { @Throws(ZCException::クラス) override suspend fun getAccessToken(): String? { 返品する ZohoSDK。getInstance(context).token。token } override fun getInitialScopes(context: Context): String { 返品する '' } override fun isUserSignedIn(): Boolean { 返品する ZohoSDK。getInstance(context).isUserSignedIn
} override fun getUserData(): Any? { 返品する null } override fun getTransformedUrl(url: String): String { 返品する url } override fun checkAndLogout(): Boolean { 返品する 無効 } override fun isEnhanceTokenNeeded(newScopes: String): Boolean { 返品する 無効 } override fun enhanceToken(tokenHelper: ZCOauthHelper。ZCOAuthTokenHelper, newScopes: String) { } override fun enhanceTokenWithOnDemandScope(tokenHelper: ZCOauthHelper。ZCOAuthTokenHelper) { }} -
認証インターフェイスのインスタンスを Creator SDK に設定するため、アプリケーション/アクティビティの onCreate メソッドに次のコードを追加します:
ZCAPIUtil.setOAuthHelper(ZCAuthImpl(applicationContext)) -
アプリケーション/アクティビティの onCreate メソッドで Zoho Creator SDK を初期化します:
ZCAPIUtil.initialize(applicationContext)
-
よくある質問(FAQ)
- ビルドの生成中にマージコンフリクトが発生します。どう対処すればよいですか?
AndroidManifest.xml ファイルの application タグ内に tools:replace='android:allowBackup' を追加して、再度お試しください。 - 'Duplicate class android.support.v4.app' エラーが発生します。どうすればよいですか?
このエラーを解消するには、gradle.properties ファイルに android.enableJetifier=true を追加してください。 - 'Duplicate class androidx.lifecycle.ViewModelLazy found in jetified' エラーが発生します。どうすればよいですか?
このエラーを解消するには、依存関係リストに implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.4.0' を追加してください。
参考資料
- サンプルコードスニペット
- サンプルアプリケーション
- Android SDK ドキュメントでは、各種 SDK メソッドの詳細を確認できます。