「Android UIライブラリ」

「Android UIライブラリ」

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

このヘルプページはCreator 6のユーザー向けです。古いバージョン(Creator 5)をお使いの場合は、こちらをクリックしてください。Creatorのバージョンをご確認いただくには、こちらをご覧ください。
Android UIライブラリは、モジュールのUIコンポーネントを使用したり、独自のカスタムUIを設計するのに役立ちます。

前提条件

  • 最新バージョンのAndroid Studio

AndroidアプリをZohoに登録する

  1. 左側のパネルから「モバイル」をクリックしてください。
  2. イオスアプリのコアフレームワークを設定したい行をクリックします。右側に「ユーザー用-SDK」パネルが開きます。 

  3. クライアントを生成」をクリックしてください。

  4. これにより、AndroidアプリとCreatorアプリケーションを統合するための「クライアントID」、「クライアントシークレット」、「リダイレクト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:zaccountssdk:V1_3'
      }
    3. IDE内に表示されるバー内の「今すぐ同期」をクリックしてください。
  2. プロジェクトを以下のコードで設定してください:
    1. アプリの  strings.xml  に以下の文字列を追加します:
      <string name='ui.label.appname' translatable='false'> あなたのアプリ名 </string>
      <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><!-- 各DCのアカウントURLを入力します。 例:USユーザーは「 https://accounts.zoho.com'. 」を使用します-->
       
      クリエイターアカウントの  ベースURL  は、関連付けられている  データセンター  に依存します。  詳細はこちら
    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 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. 以下のように、クリエイター認証インターフェース  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 にインスタンスを設定するために、次のコードを追加してください:
      ZCAPIUtil.setOAuthHelper(ZCAuthImpl(applicationContext))
    8. アプリケーションタグの下に、次のものを AndroidManifest.xml ファイルに追加してください。
      android:name='com.zoho.creator.a.ZCreatorApplication'

よくある質問

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

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