「Androidコアライブラリ」

「Androidコアライブラリ」

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

このヘルプページはCreator 6のユーザー用です。古いバージョン(Creator 5)の場合は、こちらをクリックしてください。Creatorのバージョンを確認します。

顧客アプリ用のAndroidコアライブラリのインストール

Zoho CreatorのAndroid SDKのコアライブラリを使用すると、Creatorアプリケーション内にあるデータを使用してカスタムUIを作成し、Androidアプリを構築できます。

前提条件

  • Android Studioの最新バージョン

AndroidアプリをZohoに登録する

  1. Zoho Creatorアプリケーションを編集します。
  2. その設定ページに移動します。
  3. 「開発者ツール」の下にある「モバイルSDK」をクリックします。
  4. 「顧客向け」セクションの下にある「Android用」をクリックします。右からパネルがスライドしてきます。
  5. 「Core」ライブラリを選択します。
  6. 「Generate Client Credentials」をクリックします。これにより、Creatorアプリケーションと統合しようとしているAndroidアプリのクライアントIDとクライアントシークレットが生成されます。
  7. 「zcapp_info.properties」ファイルをダウンロードし、プロジェクトの「raw」フォルダーに追加します:「<あなたのプロジェクトフォルダー>/app/src/main/res/raw」(この場所に「raw」フォルダーがない場合は作成します)

Kotlin

「Kotlin」
注意: Androidアプリの最低SDKバージョンは22以上である必要があります。
  1. AndroidアプリとSDKを統合する:
    1. app/build.gradle内にZoho maven リポジトリのURLを追加します:
      allprojects {
            repositories {
                  google()
                  mavenCentral()
                  maven {
                             url 'https://maven.zohodl.com'
                  }
                  jcenter()
            }
      }
      注:build.gradle内にリポジトリのURLを追加する際に、Build was configured to prefer settings repositories over project repositoriesという問題が発生する可能性があります。続行するには、settings.grade内にリポジトリのURLを追加する必要があります。
    2. Zoho Creator Core Library と Authentication Library を、 app/build.gradle に統合します:
      dependencies {
           implementation 'com.zoho.creator:creator-core:1.4'
           implementation 'com.zoho.accounts.android:zaccountsclientportalsdk:V2_0'
      }
    3. IDE内に表示されるバー内の「今すぐ同期」をクリックしてください。
  2. プロジェクトを次のコードで設定してください:
    1. アプリの strings.xml に以下の文字列を追加してください:
      <string name='iam_portal_url'>https://accounts.zohoportal.com</string> <!--各DCのアカウントURLを入力してください。 例:EUユーザーはhttps://accounts.zohoportal.eu-->
      <string name='c_id'> 生成されたクライアントID </string>
      <string name='c_secret'> 生成されたクライアントシークレットID </string>
      <string name='c_portal'> ポータルID </string>
      <string name='redir_url'> 登録済みのリダイレクトURI</string>
    2. アプリケーション/アクティビティクラス内の oncreate メソッドで、次のようにAccounts SDKを初期化します。
      IAMClientSDK.getInstance(this).init(scopes)
      ここでscopes - 'aaaserver.profile.READ,zohocontacts.userphoto.READ,ZohoContacts.contactapi.READ,
      ZohoCreator.meta.CREATE,ZohoCreator.meta.READ,ZohoCreator.meta.UPDATE,
      ZohoCreator.meta.DELETE,ZohoCreator.data.CREATE,ZohoCreator.data.READ,
      ZohoCreator.data.UPDATE,ZohoCreator.data.DELETE,ZohoCRM.modules.READ,
      ZohoCRM.users.READ'
      注: バージョン1.4以降のスコープリストが更新されています。
    3. アクティビティを HandleRedirectActivity という名前で作成し、 oncreate メソッドに以下のコードを追加します。
      IAMClientSDK.getInstance(this).handleRedirection(this)
    4. 次のコードをAndroidManifest.xmlファイルに追加してください:
      <activity android:name='.HandleRedirectActivity' android:exported='true'>
      <intent-filter>
           <action android:name='android.intent.action.VIEW' />
           <category android:name='android.intent.category.DEFAULT' />
           <category android:name='android.intent.category.BROWSABLE' />
           <data android:scheme='<REDIRECT_URI_WITHOUT_COLON_AND_SLASH>' />
      </intent-filter>
      </activity>
    5. ログイン画面を開くには、以下のコードスニペットを追加してください:
      val sdk = IAMClientSDK.getInstance(applicationContext)if (!sdk.isUserSignedIn) {    sdk.presentLoginScreen(this, object : IAMTokenCallback {        override fun onTokenFetchInitiated() {        }        override fun onTokenFetchComplete(zohoToken: IAMToken) {            //<このメソッドは、ユーザーが正常にログインした後に呼び出されます>        }        override fun onTokenFetchFailed(zohoErrorCodes: IAMErrorCodes) {            //<このメソッドは、ログイン中にエラーが発生した場合に呼び出されます。エラーコードをこのコールバックで受け取ります。>        }    }, null)} else {    // 最初のアクティビティへの開始インテント}
    6. 以下のように、クリエイター認証インターフェースZCOauthHelperを実装します:
      class ZCAuthImpl(private val context: Context) : ZCOauthHelper {    @Throws(ZCException::class)    override suspend fun getAccessToken(): String? {        return suspendCoroutine { continuation ->            IAMClientSDK.getInstance(context).getToken(object : IAMTokenCallback {                override fun onTokenFetchInitiated() {                }                override fun onTokenFetchComplete(token: IAMToken) {                    continuation.resumeWith(Result.success(token.token))                }                override fun onTokenFetchFailed(errorCode: IAMErrorCodes) {                    continuation.resumeWith(Result.success(null))                }            })        }    }    override fun isUserSignedIn(): Boolean {        return IAMClientSDK.getInstance(context).isUserSignedIn    }    override fun getUserData(): Any? {        return null    }    override fun getTransformedUrl(url: String): String {        return url    }    override fun checkAndLogout(): Boolean {        return false    }    override fun isEnhanceTokenNeeded(scope: String): Boolean {         return false     }    override fun enhanceToken(tokenHelper: ZCOauthHelper.ZCOAuthTokenHelper) {     }}
    7. アプリケーションの/アクティビティのoncreateメソッドに以下のコードスニペットを追加して、認証インターフェイスのインスタンスをCreator SDKに設定します。
      ZCAPIUtil.setOAuthHelper(ZCAuthImpl(applicationContext))
    8. アプリケーションの/アクティビティのoncreateメソッドでZohoCreator SDKを初期化します:
      ZCAPIUtil.initialize(applicationContext)

よくある質問

  1. ビルドを作成する際にマージコンフリクトが発生しました。解決方法は?
    アプリケーションタグの下にtools:replace='android:allowBackup'を追加し、AndroidManifest.xmlファイルを再度試してみてください。
  2. 「Duplicate class android.support.v4.app」エラーが表示されます。どうすればいいですか?
    このエラーを解決するには、gradle.propertiesファイルにandroid.enableJetifier=trueを追加する必要があります。
  3. 「Duplicate class androidx.lifecycle.ViewModelLazy found in modules jetified」エラーが表示されます。どうすればいいですか?
    このエラーを解決するには、依存関係リストにimplementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.4.0'を追加する必要があります。

参考文献



    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



              Zoho Desk Resources

              • Desk Community Learning Series


              • Digest


              • Functions


              • Meetups


              • Kbase


              • Resources


              • Glossary


              • Desk Marketplace


              • MVP Corner


              • Word of the Day









                                • Related Articles

                                • 「Android コアライブラリ」

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 このヘルプページはCreator 6のユーザー向けです。古いバージョン(Creator 5)を使用している場合は、こちらをクリックしてください。Creatorのバージョンを確認するについてはこちらをご覧ください。 Zoho CreatorのAndroid ...

                                Resources

                                Videos

                                Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                eBooks

                                Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                Webinars

                                Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                CRM Tips

                                Make the most of Zoho CRM with these useful tips.