さまざまなメソッドとその使用方法を理解していただくために、モバイル SDK を使用して顧客向けのサンプルアプリケーションを作成しました。アプリをインストールするには、次の条件を満たしている必要があります。

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

SDK の前提条件

• Zoho アカウント。アカウントをお持ちでない場合は、こちらからサインアップしてください。
• Zoho Creator アプリの作成
• iOS アプリを Zoho に登録すること
• Xcode IDE 15
• iOS 13 以上
• CocoaPods
• アプリを実行するためのシミュレーターまたは実機 iOS デバイス（iOS 9 以降）

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. 顧客向けセクションで、For 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 プロジェクト向けのサードパーティ製依存関係マネージャーです。

メモ: すべてのコマンドは Terminal で実行してください。

CocoaPods をインストールするには、次の手順を実行します。

1. Mac で Terminal を開きます。
2. 次のコマンドを使用します:
   
   sudo gem install cocoapods

依存関係の追加

1. ZylkerCarCare > native フォルダ（Xcode プロジェクト ディレクトリ）内の podfile ファイルを探します。
   
2. podfile に次の内容が含まれていることを確認します:
   
   target 'Zylker サービス' do
   use_frameworks!
   pod 'ZohoPortalAuth'
   pod 'ZCUIFramework'
   end
   
   post_install do |installer|
   installer。generated_projects。each do |プロジェクト|
   プロジェクト。targets。each do |target|
   target。build_configurations。each do |config|
   config。build_settings['CODE_SIGNING_ALLOWED'] = 'いいえ'
   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 ファイル内で、XCode で ZylkerCarCare > native > ZylkerCarService。xcworkspace を開き、AppHandler。swift に移動します。
2. 以下に示すすべてのパラメーターを入力します:
   
   letclientId = <#String!#>
   letclientSecret = <#String!#>
   leturlScheme = <#String!#>
   letportalID = <#String!#> //アプリケーションの顧客ポータルにアクセスするためのポータル ID。
   let accountsUrl =<#String!#> //ここにはポータル URL を指定します。例: 'https://demoapp.zohocreatorportal.com'
3. 入力した URL スキーム（リダイレクト URI）は、ZylkerCarCare-> Info -> URL Types で設定されている必要があります。
   

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

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

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

   

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

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

ファイルが見つからない場合は、次の手順に従って作成できます。

1. Header File を選択します:
   
2. Header File の名前を入力します。
   
3. プロジェクトの Build Settings でヘッダーファイルを設定します。
   
4. Objective-C ブリッジングヘッダー に次の行を追加します:
   

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

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