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

顧客とは、組織外の人物や団体を指します。たとえば、自社と取引のあるベンダー、小売業者、物流パートナー、顧客などです。仕様上、顧客がCreatorアプリケーションにアクセスできるようにするには、顧客ポータルを作成する必要があります。

各種メソッドとその使用方法をよりよく理解できるように、モバイルSDKを使用した顧客向けアプリケーションを作成しました。アプリをインストールするには、次の点を確認してください。

• SDKの前提条件
• Zoho Creatorアプリケーションの作成
• Zohoへのアプリの登録
• CocoaPodのインストール
• 依存関係の追加
• XcodeプロジェクトへのZoho Creatorアプリの追加
• Objective-Cブリッジヘッダーの作成

SDKの前提条件

• Zohoアカウント。アカウントをお持ちでない場合は、こちらから登録してください。
• Zoho Creatorアプリの作成
• iOSアプリのZohoへの登録
• Xcode IDE 26.0（最新のSDKバージョンに必要）
• iOS 15以降
• CocoaPods
• アプリの実行に使用するシミュレーターまたは実機のiOSデバイス（iOS 9以降）
  

メモ：

1. MacがApple Silicon（M1、M2など）搭載の場合、Rosettaを有効にしてXcodeを実行することをお勧めします。現在、XcodeのシミュレーターサポートはRosettaの実行先でのみ利用できるためです。
   
2. 互換性を確保し、最新機能を利用できるように、最新のSDKバージョンを使用することをお勧めします。CocoaPodsでは、初期設定で最新の安定版がインストールされます。特定のバージョンまたは以前のバージョンを使用するには、Podfileで明示的に指定してください。
   

Zoho Creatorアプリケーションの作成

1. こちらのリンクからサンプルアプリケーションをダウンロードします。ZylkerCarCare.zipファイルがダウンロードされます。
2. 解凍し、その中にあるZylker_Auto_Care_Chain.dsファイルを見つけます。
3. Zylker_Auto_Care_Chain.dsファイルをCreatorにインポートして、Zoho Creatorアプリケーションを作成します。手順はこちら  
4. 既定のドメインで、アプリ用の顧客ポータルを設定します。手順はこちら
5. ポータルに顧客を追加します。手順はこちら

3.Zohoへのアプリの登録

3.1 Creator 5ユーザー向けの手順

1. アプリの［設定］ページに移動し、次に［モバイルSDK］ページに移動します。
2. ［顧客向け］セクションで、［iOS向け］をクリックします。右側からペインがスライド表示されます。
3. ［UI & Core］フレームワークを選択します。
4. ［クライアント認証情報を生成］をクリックします。これにより、Creatorアプリケーションと連携するiOSアプリのクライアントID、クライアントシークレット、ポータルID、redirectURIが生成されます。
   
   
   

3.2 Creator 6ユーザー向けの手順

1. 管理者の［ダッシュボード］に移動します。
2. 左側のペインから［モバイル］を選択します。
3. 右上の［新しいモバイルアプリを作成］をクリックします。
   
   
   

4. アプリケーションの一覧から、対象のアプリを選択します。［Apple］アイコンのセクションで、［ユーザー向け - SDK］を選択します。
   
   
   

5. ［クライアントを生成］をクリックします。これにより、Creatorアプリケーションと連携するiOSアプリのクライアントID、クライアントシークレット、ポータルID、redirectURIが生成されます。
   
   
   

CocoaPodのインストール

CocoaPodsは、SwiftおよびObjective-Cプロジェクト向けのサードパーティ製依存関係マネージャーです。

メモ：すべてのコマンドはターミナルに入力してください。

CocoaPodsをインストールするには、

1. Macでターミナルを開きます
2. 以下のコマンドを使用します。
   
   sudo gem install cocoapods

依存関係の追加

1. ZylkerCarCare→nativeフォルダー（Xcodeプロジェクトディレクトリー）にpodfileファイルがあります。
   
2. podfileに以下が含まれていることを確認します。
   
   target 'ジルカーService' do
   use_frameworks!
   pod 'ZohoPortalAuth'
   pod 'ZCUIFramework'
   end
   
   post_install do |installer|
   installer.generated_projects.each do |project|
   project.targets.each do |target|
   target.build_configurations.each do |config|
   config.build_settings['CODE_SIGNING_ALLOWED'] = 'NO'
   config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
   end
   end
   end
   
   end
3. ターミナルを開き、ZylkerCarCare→nativeフォルダー（Xcodeプロジェクトディレクトリー）に移動して、以下のコマンドを実行します。
   
   pod install
4. XcodeプロジェクトでZylkerCarService.xcworkspaceを開きます。
   

サンプルXcodeプロジェクトへのZoho Creatorアプリの追加

1. ダウンロードしたzipファイルで、ZylkerCarCare→native→ZylkerCarService.xcworkspaceをXcodeで開き、AppHandler.swiftに移動します。
2. 以下のすべてのパラメーターを入力します。
   
   letclientId = <#String!#>
   letclientSecret = <#String!#>
   leturlScheme = <#String!#>
   letportalID = <#String!#> //アプリケーションのカスタマーポータルにアクセスするためのポータルID。
   let accountsUrl =<#String!#> //ここにはポータルURLを指定します。例：'https://demoapp.zohocreatorportal.com'
3. 入力したURLスキーム（リダイレクトURI）は、ZylkerCarCare→［情報］→［URLタイプ］で設定する必要があります。
   

4. ［コアフレームワークの設定］タブからZCAppInfo.plistファイルをダウンロードします（上記のセクションの手順1～3を参照してください）。
   
   • C6の場合は、以下の画像を参照してください。
     

5. ZCAppInfo.plistファイルをZylkerCarCare→native→ZylkerCarServiceフォルダーに移動します。
   

6. ZCAppInfo.plistファイルをプロジェクトに追加し、すべてのターゲットに関連付けます。
   

   

Objective-Cブリッジングヘッダー

プロジェクト内にZylkerCarService-Bridging_header.hファイルが存在するか確認してください。以下の画像はファイルの場所を示しています。

ファイルが見つからない場合は、以下の手順で作成できます。

1. ［ヘッダーファイル］を選択します。
   
2. ［ヘッダーファイル］の名前を入力します。
   
3. ［プロジェクト］→［ビルドオプション］でヘッダーファイルを設定します。
   
4. Objective-Cブリッジングヘッダーに以下を追加します。
   

       #インポート <ZohoPortalAuthKit/ZohoPortalAuth.h> 

5. プロジェクトをコンパイルします。この手順でエラーが発生した場合は、こちらのページを参照してください。