「Android コアライブラリ」

「Android コアライブラリ」

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

このヘルプページはCreator 6のユーザー向けです。古いバージョン(Creator 5)を使用している場合は、こちらをクリックしてください。Creatorのバージョンを確認するについてはこちらをご覧ください。
Zoho CreatorのAndroid SDKのコアライブラリを使用することで、Creatorアプリケーション内のデータを使用して、 カスタムUIを作成し、Androidアプリを構築 することができます。

前提条件

  • 最新バージョンのAndroid Studio

AndroidアプリをZohoに登録する

  1. 左側のパネルから モバイル をクリックしてください。
  2. Androidアプリのコアフレームワークを構成したい行をクリックします。右側に For User - SDK パネルが開きます。 

  3. Generate Client をクリックしてください。

  4. Creatorアプリと統合したいAndroidアプリの client IDclient secret、およびredirectURIが生成されます。

  5. zcapp_info.properties ファイルをダウンロードし、プロジェクトの raw フォルダーに追加してください:'<your_project_folder>/app/src/main/res/raw'。(この位置に raw フォルダーがない場合は作成してください)

Kotlinを使用してユーザーアプリのAndroidコアライブラリをインストールする

注意:Androidアプリは、最低SDKバージョン22以上が必要です。

  1. AndroidアプリとSDKを統合する:
    1. Zoho maven リポジトリのURLを  app/build.gradle に追加します:
      allprojects {
            repositories {
                  google()
                  mavenCentral()
                  maven {
                             url 'https://maven.zohodl.com'
                  }
                  jcenter()
            }
      }
      注意:build.gradleにリポジトリURLを追加すると、Buildがプロジェクトリポジトリよりも設定リポジトリを優先するように構成されているという問題が発生する可能性があります。続行するには、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:zaccountssdk:V1_3'
      }
    3. IDE内に表示されるバー内の「Sync Now」をクリックしてください。
  2. プロジェクトを次のコードで設定します:
    注意:ユーザー向け - SDK 右ペインのクライアント詳細ボックスの横にある「コピー」をクリックすると取得できます。
    1. 以下の文字列をアプリの  strings.xml  に追加してください:
      <string name='c_id'> 生成されたクライアントID </string>
      <string name='c_secret'> 生成されたクライアントシークレットID </string>
      <string name='redir_url'> 登録済みのリダイレクトURI</string>
      <string name='accounts_url'> https://accounts.zoho.com</string>
    2. アプリケーション/アクティビティクラスの oncreate メソッド内で、アカウントSDKを以下のように初期化します:
      ZohoSDK.getInstance(this).init(scopes, showlogs);
      ここで、
      • 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,Stratus.stratusop.READ,
        ZohoCRM.modules.READ,ZohoCRM.users.READ'
        注: スコープリストはバージョン1.4以降に更新されています。
      • showLogs - デバッグログを表示するかどうか
    3. アクティビティを作成してください: HandleRedirectActivity 、そして oncreate メソッドに以下のコードを追加してください:
      ZohoSDK.getInstance(this).handleRedirection(this);
    4. 次のコードを  AndroidManifest.xml  ファイルに追加します:
      <activity 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='<REDIRECTURI_WITHOUT_COLON_AND_SLASH>' />
            </intent-filter>
      </activity>
    5. ログイン画面を開くには、以下のコードスニペットを追加してください:
      val sdk = ZohoSDK.getInstance(applicationContext)if (!sdk.isUserSignedIn) {   sdk.presentLoginScreen(this, object : ZohoTokenCallback {      override fun onTokenFetchInitiated() {      }      override fun onTokenFetchComplete(zohoToken: ZohoToken?) {         // このメソッドは、ユーザーが正常にログインした後に呼び出されます      }      override fun onTokenFetchFailed(zohoErrorCodes: ZohoErrorCodes?) {         // このメソッドは、ログイン中にエラーが発生した場合に呼び出されます。 このコールバックでエラーコードを受け取ります。      }   }, null)} else {   // 最初のアクティビティへのインテントを開始します}
    6. 以下のようにCreator認証インターフェース  ZCOauthHelper  を実装します。
      class ZCAuthImpl(private val context: Context) : ZCOauthHelper {    @Throws(ZCException::class)    override suspend fun getAccessToken(): String? {        return ZohoSDK.getInstance(context).token.token    }    override fun isUserSignedIn(): Boolean {        return ZohoSDK.getInstance(context).isUserSignedIn    }    override fun getUserData(): Any? {        return null    }    override fun getTransformedUrl(url: String): String {        return url    }    override fun checkAndLogout(): Boolean {        return ZohoSDK.getInstance(context).checkAndLogout()    }override fun isEnhanceTokenNeeded(scope: String): Boolean {        return false    }    override fun enhanceToken(tokenHelper: ZCOauthHelper.ZCOAuthTokenHelper) {    }}
    7. アプリケーションの/アクティビティの oncreate メソッドに次のコードを追加して、Creator SDKにAuthenticationインターフェースのインスタンスを設定します。
      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がモジュール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のバージョンを確認します。 顧客アプリ用のAndroidコアライブラリのインストール Zoho CreatorのAndroid ...
                                • 「Android SDKの使い方」

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 このヘルプページはCreator 6のユーザー向けです。古いバージョン(Creator 5)をお使いの場合は、こちらをクリックしてください。Creatorバージョンをご確認ください。 モバイルソフトウェア開発キット(mobile SDKSDKフォーム, レポート, および、 ...
                                • 「Androidアプリにプッシュ通知を設定する」

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

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

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