顧客向けiOSサンプルアプリケーション

顧客向けiOSサンプルアプリケーション

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

顧客とは、組織の外部にいる個人または法人を指します。たとえば、仕入先、小売業者、物流パートナー、そして組織が取引を行う顧客などです。設計上、顧客に Creator アプリケーションへのアクセスを許可するには、顧客ポータルを作成する必要があります。

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

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