ユーザー向けサンプルiOSアプリケーション

ユーザー向けサンプルiOSアプリケーション

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

各メソッドとその使用方法をより深く理解できるように、Mobile SDKを使用したアプリケーションを作成しました。アプリをインストールするには、次の手順に従います。

1. 前提条件

  • Zohoアカウント。アカウントをお持ちでない場合は、こちらから登録してください。
  • Xcode IDE 26.0（最新のSDKバージョンに必要）
  • iOS 15以降
  • CocoaPods
Notesメモ：
  1. MacがApple Silicon（M1、M2など）を搭載している場合は、Xcodeのシミュレーター対応が現在Rosettaデスティネーション経由でのみ利用可能なため、Rosettaを有効にしてXcodeを実行することをお勧めします。
  2. 互換性を確保し、最新機能を利用するには、最新のSDKバージョンを使用することをお勧めします。CocoaPodsでは、初期設定で最新の安定版がインストールされます。特定のバージョンまたは以前のバージョンを使用するには、Podfileで明示的に指定してください。

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

  1. こちらのリンクからサンプルアプリケーションをダウンロードします。ZohoCreatorSDKDemo.zipファイルがダウンロードされます。
  2. 展開し、その中にあるUtility.dsファイルを探します。
  3. Utility.dsファイルをCreatorにインポートして、Zoho Creatorアプリケーションを作成します。詳細はこちら  

3. Zohoへのアプリの登録

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

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

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

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

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

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

4. CocoaPodsのインストール

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

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

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

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

5. 依存関係の追加

  1. podfileファイルは、ZohoCreatorSDKDemo→nativeフォルダー（Xcodeプロジェクトディレクトリー）にあります。
  2. podfileに次の内容が含まれていることを確認します。
    target 'ジルカーService' do
    use_frameworks!
    pod 'ZohoAuth'
    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. ターミナルを開き、ZohoCreatorSDKDemo→nativeフォルダー（Xcodeプロジェクトディレクトリー）に移動して、次のコマンドを実行します。
    pod install
  4. XcodeプロジェクトでZohoCreatorSDKDemo.xcworkspaceを開きます。

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

  1. ダウンロードしたzipファイル内のZohoCreatorSDKDemo→native→ZohoCreatorSDKDemo.xcworkspaceをXcodeで開き、AppDelegate.swiftに移動します。
  2. 以下のすべてのパラメーターを入力します。
    varclientId = <#String!#>
    varclientSecret = <#String!#>
    varurlScheme = <#String!#>
  3. 入力したURLスキーム（リダイレクトURI）は、ZohoCreatorSDKDemo→［情報］→［URLタイプ］で設定する必要があります。

  4. ［コアフレームワークの設定］タブからZCAppInfo.plistファイルをダウンロードします（上記セクションの手順1～3を参照）。

    • C6については、以下の画像を参照してください。

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

7. Objective-Cブリッジングヘッダーの設定

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



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

  1. ［ヘッダーファイル］を選択します。
  2. ヘッダーファイルの名前を入力します。
  3. ヘッダーファイルを［プロジェクト］→［ビルドオプション］で設定します。
  4. Objective-Cブリッジングヘッダーに以下を追加します。 
        #インポート <ZohoAuthKit/ZohoAuth.h>
  5. プロジェクトをコンパイルします。この操作中にエラーが発生した場合は、こちらのページを参照してください。