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

前提条件

• Xcode IDE 16。+10、-10
• iOS 15以上
• CocoaPods
  

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

Apple Silicon Mac（M1、M2チップ搭載）でXcode 16。+10、-10を使用する場合、現時点ではRosettaのデスティネーションでSimulatorを実行する場合のみサポートしています。

iOSアプリをZohoに登録する

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

1. 左側のペインにあるモバイルセクションに移動し、SDKタブをクリックします。
2. UIフレームワークを設定したいiOSアプリの該当行をクリックします。右側にFor 顧客 - SDKペインが表示されます。
   

   

3. 生成する Clientをクリックします。
   

   

4. これにより、連携したいiOSアプリ用のClient ID、Clientシークレット、ポータルID、RedirectURIが生成されます。
   

   

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

   

顧客アプリ用iOS UIフレームワークのインストール

1. Podを使ってZoho Creator SDKをインストールします：
   
   pod specsをPodfileに追加します：
   
   target 'デモ' 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['IPHONE_DEPLOYMENT_TARGET'] = '13。+10、-10'
   end
   end
   end
   end
2. Objective-Cブリッジングヘッダーに次を追加します：
   

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

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

   インポートする ZCUIFramework
   

4. 次のコードでプロジェクトを設定します（例：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)
      }
      let scope = 
      let clientID = 
      let clientSecret = 
      let portalId = 
      let urlScheme = 
      let accountsUrl = https://取引先.zohoportal。com' //ご利用のDCに応じた取引先URLを入力してください。例：EUユーザーは https://取引先.zohoportal。eu'.// アプリがすでにログインしている場合に認証を行う
   
   // 未ログインの場合
   self.showLoginScreen()
   
   // アプリはすでにログイン済みです。
   // Creator SDKのメソッドを利用する前に、必ず次のコードの折れ線グラフをiOSアプリに使用してください。Set<UIOpenURLContext>){iflet=URLContexts.first{let_=ZohoPortalAuth.handleURL(.,:..,:..)}}}extensionSceneDelegate:ZCUIServiceDelegate{funcoAuthToken(:AccessTokenCompletion){ZohoPortalAuth.{(,)incompletion(,)}}funcopenURL(for:[OpenUrlTask]){// 取得する callback here when openURL has query string 'zc_MobileSDK_HandleOpenURL=真'}}

   
   
   ZohoポータルへのログインをiOSアプリで許可するためのコード：
   

    func showLoginScreen() {

    ZohoPortalAuth.presentZohoPortalSign( in: {
     (token, error) in
     if token != nil {
      //ログインが完了しました
     }
    })
   }

   
   
   Zohoポータルからログアウトを実行するコード：
   

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

5. 以下のキーに対して values をZcAppInfo。plist に追加してください。これらは、Appleのプライバシー準拠に必須のパラメーターです。該当するサービスはUIフレームワークで使用中です。
   
   'NSCameraUsageDescription', 'NSContactsUsageDescription', 'NSLocationWhenInUseUsageDescription', 'NSMicrophoneUsageDescription', 'NSPhotoLibraryUsageDescription' および 'NSPhotoLibraryAddUsageDescription'