「Android UIライブラリ」

「Android UIライブラリ」

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

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

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

Android UIライブラリは、モジュールのUIコンポーネントを使用したり、独自のカスタムUIを設計するのに役立ちます。 

前提条件

  • 最新バージョンのAndroid Studio

ZohoにAndroidアプリを登録する

  1. 左側のパネルからモバイルセクションに移動し、SDKタブをクリックしてください。
  2. UIフレームワークを設定したいAndroidアプリの行をクリックします。右側にFor Customers - SDKパネルが開きます。

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

  4. Creatorアプリケーションと統合したいAndroidアプリのclient IDclient secretPortal ID、およびRedirect URIが生成されます。

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

Kotlinを使用して顧客アプリのAndroid UIライブラリをインストールする

注意: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 was configured to prefer settings repositories over project repositories の問題が発生する可能性があります。 続行するには、 settings.gradeにリポジトリURLを追加する必要があります。
    2. Zoho Creator UI Library と Authentication Library を、app/build.gradle に統合してください。
      dependencies {
         implementation 'com.zoho.creator:creator-ui:1.4'
         implementation 'com.zoho.accounts.android:zaccountsclientportalsdk:V2_0'
      }
    3. IDE内に表示されたバーから、「今すぐ同期」をクリックしてください。
  2. プロジェクトを次のコードで設定します:
    1. アプリの strings.xml に以下の文字列を追加してください:
      <string name='ui.label.appname' translatable='false'> あなたのアプリ名 </string>
      <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'> 登録済みのREDIRECTURI</string> <!--これらのパラメーターは、ポイント2で記載されたURLから取得されます-->
    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,Stratus.stratusop.READ,
      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='<REDIRECTURI_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 {    // start intent to first activity}
    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. アプリケーションタグの下に、次を AndroidManifest.xml ファイルに追加してください:
      android:name='com.zoho.creator.a.ZCreatorApplication'

質問と回答

  1. ビルドを生成する際、マージコンフリクトが発生しています。どう解決すればよいですか?
    AndroidManifest.xml ファイル内のアプリケーションタグの下に tools:replace='android:allowBackup,android:label,android:theme' を追加してからもう一度お試しください。
  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 WorkDrive Resources



                Zoho Desk Resources

                • Desk Community Learning Series


                • Digest


                • Functions


                • Meetups


                • Kbase


                • Resources


                • Glossary


                • Desk Marketplace


                • MVP Corner


                • Word of the Day









                                  • Related Articles

                                  • 「Android UIライブラリ」

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

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

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

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