iOSコアフレームワーク

iOSコアフレームワーク

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


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

前提条件

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

    サポートされているSDKバージョンと対応するXcodeバージョンの一覧については、こちらを参照してください。

ZohoへのiOSアプリの登録

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

  1. 左側のペインで[モバイル]セクションに移動し、[SDK]タブをクリックします。
  2. コアフレームワークを設定するiOSアプリの対象行をクリックします。右側に[顧客向け - SDK]ペインが開きます。

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

  4. これにより、Creatorアプリケーションと連携するiOSアプリのクライアントIDクライアントシークレットポータルIDredirectURIが生成されます。

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

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

  1. Podを使用してZoho Creator SDKをインストールします。
    target 'Demo' do
    use_frameworks!
    pod 'ZohoPortalAuth'
    pod 'ZCCoreFramework'
    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'
    end
    end
    end
    end
  2. Objective-Cブリッジングヘッダーに次を追加します。
    #インポート <ZohoPortalAuthKit/ZohoPortalAuth.h> 
  3. Zoho Creator SDKのiOSコアフレームワークを使用するには、ZCCoreFrameworkをインポートします。
    インポート ZCCoreFramework
  4. たとえばSceneDelegateファイルで、次のコードを使用してプロジェクトを設定します。
class 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 =
['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 portalId =
'<Your Portal ID>'
let urlScheme =
'<Your Url Scheme>'
let accountsUrl =
'https://accounts.zohoportal.com' // enter the accounts URL of your respective DC. For eg: EU users must use 'https://accounts.zohoportal.eu'
ZohoPortalAuth.initWithClientID(clientID, clientSecret: clientSecret, portalID: portalId, scope: scope, urlScheme: urlScheme, mainWindow: self.window!, accountsPortalURL: accountsUrl)

// To verify if the app is already logged in

ZohoPortalAuth.getOauth2Token {
(token, error) in
if token ==
nil {
// Not logged in
self.showLoginScreen()
} else {
// App logged in already.
// Ensure to use the following line of code in your iOS app before you utilize any of Creator SDK's methods
Creator.configure(delegate: self)
}
}
}

func scene(
_ scene: UIScene, openURLContexts URLContexts: Set <UIOpenURLContext> ) {
if let context = URLContexts.first {
let
_ = ZohoPortalAuth.handleURL(context.url,
sourceApplication: context.options.sourceApplication,
annotation: context.options.annotation)
}
}
}

拡張機能 SceneDelegate: ZCCoreFrameworkDelegate {
func oAuthToken(with completion: @escaping AccessTokenCompletion) {
ZohoPortalAuth.getOauth2Token {
(token, error) in
completion(token, error)
}
}
}

iOSアプリにZoho Portalログインを追加するためのコード。
func showLoginScreen() {
ZohoPortalAuth.presentZohoPortalSign( in: {
(token, error) in
if token !=
nil {
//login success
}
})
}

Zoho Portalからのログアウトを設定するコード。
func logout() {
ZohoPortalAuth.revokeAccessToken {
(error) in
if error ==
nil {
//Logout Successfully
}
else {
//Error Occurred
}
}
}

よくある質問

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

参考情報

  • 各種SDKメソッドの詳細については、iOS SDKドキュメントを参照してください。
  • サンプルアプリケーションをこちらからお試しいただき、Mobile SDK for iOSについて理解を深めてください。
  • iOSのプッシュ通知を設定するには、こちらを参照してください。

ユーザー

顧客