お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の
英語版を参照してください。
CreatorのiOS SDKのコアフレームワークでは、カスタムUIを作成し、Creatorアプリケーション内のデータを使用してユーザー向けにiOSアプリを構築できます。
前提条件
- Xcode IDE 26.0(最新のSDKバージョンに必要)
- iOS 15以上
- CocoaPods
メモ:
- MacがApple Silicon(M1、M2など)搭載の場合、Xcodeでのシミュレーターサポートは現在Rosettaのデスティネーション経由でのみ利用できるため、Rosettaを有効にしてXcodeを実行することをおすすめします。
- 互換性を確保し、最新機能を利用するため、最新のSDKバージョンを使用することをおすすめします。CocoaPodsでは、初期設定で最新の安定版がインストールされます。特定のバージョンや以前のバージョンを使用するには、Podfileで明示的に指定してください。
サポート対象のSDKバージョンと互換性のあるXcodeバージョンの一覧については、こちらを参照してください。
ZohoへのiOSアプリの登録
iOSアプリをZohoに登録すると、Client IDとClient Secretの組み合わせが生成されます。これらは、iOSアプリをCreatorアプリケーションと連携させるために必要です。iOSアプリをZohoに登録するには、以下の手順を実行します。
- 左側のパネルで[モバイル]をクリックします。
-
コアフレームワークを設定するiOSアプリの対象行をクリックします。右側の[ユーザー向け - SDK]パネルが開きます。
-
[クライアントを生成]をクリックします。

-
これにより、Creatorアプリケーションと連携させるiOSアプリ用のClient ID、Client Secret、RedirectURIが生成されます。

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

ユーザーアプリ用iOSコアフレームワークのインストール
-
Podを使用してZoho Creator SDKをインストールします。
target 'Demo' do
use_frameworks!
pod 'ZohoAuth'
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'
config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
end
end
end
end
-
次のステートメントをブリッジングヘッダーに追加します。
#インポート <ZohoAuthKit/ZohoAuth.h>
-
Zoho Creator iOS SDKのコアフレームワークを使用するには、ZCCoreFrameworkをインポートします。
import ZCCoreFramework
-
たとえば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 Configuration
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' // enter the accounts URL of your respective DC. For eg: EU users use 'https://accounts.zoho.eu'.
ZohoAuth.initWithClientID(clientID, clientSecret: clientSecret, scope: scope, urlScheme: urlScheme, mainWindow: window, accountsURL: accountsUrl)
// To verify if the app is already logged in
ZohoAuth.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 _ = ZohoAuth.handleURL(context.url,
sourceApplication: context.options.sourceApplication,
annotation: context.options.annotation)
}
}
}
拡張機能 SceneDelegate: ZCCoreFrameworkDelegate {
func oAuthToken(with completion: @escaping AccessTokenCompletion) {
ZohoAuth.getOauth2Token {
(token, error) in
completion(token, error)
}
}
func configuration() -> CreatorConfiguration {
return CreatorConfiguration(creatorURL:'https://creator.zoho.com') // enter the creator URL of your respective data center (DC). For eg: EU users must use https://creator.zoho.eu
}
}
iOSアプリにZohoログインを追加するためのコード。
func showLoginScreen() {
ZohoAuth.presentZohoSign( in: {
(token, error) in
if token != nil {
// success login
// 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)
}
})
}
Zohoからのログアウトを設定するためのコード。
func logout() {
ZohoAuth.revokeAccessToken {
(error) in
if error == nil {
//Logout Successfully
}
else {
//Error Occurred
}
}
}
よくある質問
- M1 Macユーザーです。依存関係の追加時に問題が発生します。どうすればよいですか?
続行するには、arch=x86_64 pod installコマンドを使用してください。
参考情報
- サンプルコードスニペットについては、サンプルページを参照してください。
- 各種SDKメソッドの詳細については、iOS SDKドキュメントを参照してください。
- Mobile SDK for iOSについて理解を深めるには、サンプルアプリケーションをお試しください。こちらからアクセスできます。
- iOSのプッシュ通知を設定するには、こちらを参照してください。
ユーザー
顧客