iOSコアフレームワーク

iOSコアフレームワーク

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


Notesこのヘルプページは Creator 6 をご利用のユーザー向けです。旧バージョン(Creator 5)をお使いの場合は、こちらをクリックしてください。ご利用中のCreator のバージョンを確認してください。
Creator の iOS SDK のコアフレームワークを使用すると、カスタム UIを作成し、Creator アプリケーション内のデータを利用してiOS アプリを作成し、ユーザーに提供できます。

前提条件

Notesメモ: Mac が Apple Silicon(M1、M2 など)搭載の場合は、Rosetta を有効にして Xcode を実行する必要があります。

Apple Silicon 搭載 Mac(M1、M2 チップなど)で Xcode 16.0 を使用する場合、現在は Rosetta を使用したシミュレーターデスティネーションでの実行のみをサポートしています(Intel Mac での実行とは異なります)。

iOS アプリを Zoho に登録する

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

  1. [モバイル] を左ペインからクリックします。
  2. コアフレームワークを設定したい iOS アプリの行をクリックします。右ペインに [ユーザー向け - SDK] が表示されます。

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

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

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

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

  1. Pod を使用して Zoho Creator SDK をインストールします。
    target 'デモ' do
    use_frameworks!
    pod 'ZohoAuth'
    pod 'ZCCoreFramework'
    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
  2. 次の記述をブリッジングヘッダーに追加します。
    #インポートする <ZohoAuthKit/ZohoAuth.h> 
  3. Zoho Creator iOS SDK のコアフレームワークを使用するには、ZCCoreFramework をインポートします。
     import ZCCoreFramework
  4. プロジェクトを次のコードで設定します(例:SceneDelegate ファイル内)。
                      
     
    classSceneDelegate: 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.設定する(delegate: 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: ZCCoreFrameworkDelegate {
  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 を使用します。
   }
  }

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 {
   // エラーが発生しました
  }
 }
}

よくある質問(FAQ)

  1. M1 Mac ユーザーで、依存関係の追加時に問題が発生しています。どうすればよいですか?
    続行するには、arch=x86_64 pod install コマンドを使用してください。

参考情報

  1. サンプルコードスニペットについては、examples ページを参照してください。
  2. 各種 SDK メソッドの詳細については、 iOS SDK ドキュメントを参照してください。
  3. サンプルアプリケーションを試して、iOS 向けモバイル SDK に慣れてください。サンプルアプリケーションは こちらから利用できます。
  4. iOS 向けプッシュ通知を設定するには、こちらを参照してください。

ユーザー

顧客