このヘルプページは Creator 6 をご利用のユーザー向けです。旧バージョン（Creator 5）をご利用の場合は、こちらをクリックしてください。ご利用中のCreator のバージョンを確認しましょう。

前提条件

• Xcode IDE 16.0
• iOS 15 以上
• CocoaPods
  

メモ: Mac が Apple Silicon（M1、M2 など）搭載の場合は、Rosetta を有効にして Xcode を実行することを推奨します。

Apple Silicon 搭載 Mac（M1、M2 チップなど）で Xcode 16.0 を使用する場合、現時点では Rosetta を使用した Simulator 宛先での実行のみをサポートしています（Intel Mac での実行は対象外）。

iOS アプリを Zoho に登録する

iOS アプリを Zoho に登録すると、クライアント ID と クライアントシークレット の組み合わせが生成されます。これらは、iOS アプリを Creator アプリケーションと連携させるために必須です。iOS アプリを Zoho に登録するには、次の手順を実行します。

1. 左ペインで モバイル をクリックします。
2. UI フレームワークを設定したい iOS アプリの対象行をクリックします。右側に ユーザー向け - SDK ペインが開きます。
   

   

3. クライアントを生成 をクリックします。
   

   

4. これにより、Creator アプリケーションと連携させたい iOS アプリ用の クライアント ID、クライアントシークレット、リダイレクト URI が生成されます。
   

5. ZCAppInfo.plist ファイルをダウンロードし、プロジェクトに追加します。
   

   

ユーザーアプリ向け iOS UI フレームワークをインストールする

1. Pod を使用して Zoho Creator SDK をインストールします。
   
   1. Podfile に次の pod spec を追加します。
      
      target 'デモ' do
      use_frameworks!
      pod 'ZohoAuth'
      pod 'ZCUIFramework'
      end
      プロジェクト。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
   2. Podfile を含むフォルダーをターミナルで開き、次を実行します。
      
      $ pod install
2. Objective-C ブリッジングヘッダーに次を追加します。
   

   #インポートする <ZohoAuthKit/ZohoAuth.h> 

3. Zoho Creator の iOS UI フレームワークを使用するには、ZCUIFramework をインポートします。
   

   インポートする ZCUIFramework

4. プロジェクトを次のコードで設定します（例: SceneDelegate ファイル内）。
   

   クラス SceneDelegate: UIResponder, UIWindowSceneDelegate {
    var window: UIWindow?
   
     func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
      if let windowScene = scene as? UIWindowScene {
       let window = UIWindow(windowScene: windowScene)
      }
   
      // ZohoAuth の設定
   
      let scope = ['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']
      let clientID = '<Your Client ID>'
      let clientSecret = '<Your Client Secret>'
      let urlScheme = '<Your Url Scheme>'
      let accountsUrl = 'https://accounts.zoho.com' // ご利用のデータセンター (DC) に対応するアカウント URL を入力します。例: EU データセンターのユーザーは 'https://accounts.zoho.eu' を使用します。
      ZohoAuth.initWithClientID(clientID, clientSecret: clientSecret, scope: scope, urlScheme: urlScheme, mainWindow: window, accountsURL: accountsUrl)
   
      // アプリがすでにログイン済みかどうかを確認する
   
      ZohoAuth.getOauth2Token {
       (token, error) in
       if token == nil {
        // 未ログイン
        self.showLoginScreen()
       } else {
        // アプリはすでにログイン済み
        // Creator SDK のメソッドを使用する前に、必ず次のコード行を iOS アプリ内で実行してください
        Creator.設定する(uiDelegate: self)
       }
      }
     }
   
    func scene(_ scene: UIScene, openURLContexts URLContexts: Set <UIOpenURLContext> ) {
     if let context = URLContexts.first {
      let _ = ZohoAuth.handleURL(context.url,
       sourceApplication: context.options.sourceApplication,
       annotation: context.options.annotation)
     }
    }
   }
   
   extension SceneDelegate: ZCUIServiceDelegate {
     func oAuthToken(with completion: @escaping AccessTokenCompletion) {
      ZohoAuth.getOauth2Token {
       (token, error) in
       completion(token, error)
      }
     }
   
     func configuration() -> CreatorConfiguration {
      返品する CreatorConfiguration(creatorURL: 'https://creator.zoho.com') // ご利用のデータセンター (DC) に対応する Creator URL を入力します。例: EU データセンターのユーザーは 'https://creator.zoho.eu' を使用します。
      }
     func handleBrowserURL(url: URL) { 
     // UI SDK によりアプリ内で openURL を開けない場合、ここでコールバックを受け取ります
     }
      func openURL(for openURLTasks: [OpenUrlTask]) {
       // クエリ文字列 'zc_MobileSDK_HandleOpenURL=true' を含む openURL がある場合、ここでコールバックを受け取ります。
       // 例: https://app.zohocreator.com/appOwner/app-name/#Form:Test_Form?zc_MobileSDK_HandleOpenURL=true
      }
     }

   
   
   iOS アプリに Zoho ログインを追加するためのコード:
   

   func showLoginScreen() {
    ZohoAuth.presentZohoSign( in: {
     (token, error) in
     if token != nil {
      // ログイン完了
      // Creator SDK の任意のメソッドを使用する前に、必ず以下のコードを iOS アプリ内で実行してください
      Creator.設定する(delegate: self)
     }
    })
   }

   
   
   Zoho からログアウトするためのコード:
   

   func logout() {
    ZohoAuth.revokeAccessToken {
     (error) in
     if error == nil {
      // ログアウトに成功しました
     }
     else {
      // エラーが発生しました
     }
    }
   }

5. ZCAppInfo。plist 内の次のキーに値を追加します。これらは、該当するサービスが UI フレームワーク内で使用されているため、Apple のプライバシーコンプライアンスに必須のパラメーターです。
   
   'NSCameraUsageDescription', 'NSContactsUsageDescription', 'NSLocationWhenInUseUsageDescription', 'NSMicrophoneUsageDescription', 'NSPhotoLibraryUsageDescription' and 'NSPhotoLibraryAddUsageDescription'

よくある質問（FAQ）

参考情報

関連トピック

• iOS 向けモバイル SDK の概要
• プッシュ通知を設定する

ユーザー

• iOS 向けコアフレームワーク
  
• iOS 向け UI & コアフレームワーク

顧客

• iOS 向けコアフレームワーク