## 集成/制作DCloudUTSExtAPI > 参考demo中的DCloudUTSExtAPI工程 ### 新建原生工程 1. 启动`Xcode`,点击`File->New->Project`,选择`Framework`点击`Next` 2. `Product Name`中填写`DCloudUTSExtAPI`,`Language`选择为`Objective-C`,点击`Next`即可完成创建 > 你可以选择新建工程或直接使用demo中的`DCloudUTSExtAPI`工程 ### 工程环境设置 `Target -> General -> Minimum Deployments` 选择 `12.0` `Target -> Build Settings -> Mach-O Type` 设置为`Dynamic Library` `Target -> Build Settings -> Other Linker Flags` 中添加`-ObjC`, 字母o和c大写 `Target -> Build Settings -> Enable Module Verifier` 设置为`NO` `Target -> Build Settings -> Build Libraries for Distribution` 设置为`YES` `Target -> Build Settings -> Framework Search Paths` 中添加SDK的Libs目录(操作方法:双击展开`Framework Search Paths`将`SDK/Libs`文件夹拖入即可) ### 配置基础模块(必须) 将以下源文件(`SDK/ExtApiSrc 目录下`)、依赖库(`SDK/Libs 目录下`)添加到`DCloudUTSExtAPI`工程中,并将依赖库均设置为`Do Not Embed` | 源文件 | 依赖库 | 资源文件 | | --- | ---| ---| | UTSOC.h
UTSOC.mm
uni-getAppAuthorizeSetting-index.swift
uni-getAppBaseInfo-index.swift
uni-getDeviceInfo-index.swift
uni-getSystemInfo-index.swift
uni-getSystemSetting-index.swift
uni-openAppAuthorizeSetting-index.swift
uni-prompt-index.swift
uni-rpx2px-index.swift
uni-storage-index.swift
uni-theme-index.swift
uni-getElementById-DCUniGetElementById.swift
uni-getElementById-index.swift | DCloudUniappRuntime.xcframework
DCloudUTSFoundation.xcframework
DCUniToast.xcframework
DCloudAlertController.xcframework
storage.framework| uts-config.json | ### 配置其他模块(可选) 根据资源文件中的`manifest.json`文件包含的模块名称,选择以下源文件(`SDK/ExtApiSrc 目录下`)、依赖库(`SDK/Libs 目录下`)添加到DCloudUTSExtAPI工程中,依赖库均设置为`Do Not Embed` | 模块名称 | 源文件 | 依赖库 | 系统依赖库 | |---|---|---|---| | uni-createWebviewContext | uni-createWebviewContext-index.swift | | | | uni-getProvider | uni-getProvider-index.swift | | | | uni-network | uni-network-index.swift | | | | uni-getNetworkType | uni-getNetworkType-index.swift | | | | uni-websocket | uni-websocket-index.swift | websocket.xcframework
Starscream.xcframework | | | uni-canvas | | DCloudUniCanvas.xcframework | | | uni-media | uni-media-index.swift | DCloudMediaPicker.xcframework | AssetsLibrary
Photos
AVFoundation
CoreServices
CoreFoundation
CoreGraphics
CoreImage
GLKit
MetalKit
MobileCoreServices
QuartzCore
ImageIO
MediaPlayer
CoreText | | uni-payment-alipay | uni-payment-alipay-index.swift
uni-payment-index.swift | AlipaySDK.xcframework |c++
z
SystemConfiguration
CoreTelephony
QuartzCore
CoreText
CoreGraphics
CFNetwork
CoreMotion | | uni-payment-wxpay | uni-payment-wxpay-index.swift
uni-payment-index.swift | libWeChatSDK.a | CoreGraphics
WebKit
Security | | uni-virtualPayment | uni-virtualPayment-index.swift
uni-virtualPayment-ProductService.swift
uni-virtualPayment-PurchaseService.swift
uni-virtualPayment-Types.swift
uni-virtualPayment-UniProduct.swift
uni-virtualPayment-UniPurchase.swift
uni-virtualPayment-UniStoreKit+Closure.swift
uni-virtualPayment-UniStoreKit.swift | | StoreKit | | uni-getLocation-system | uni-getLocation-system-index.swift
uni-getLocation-index.swift | | | | uni-getLocation-tencent | uni-getLocation-tencent-index.swift
uni-getLocation-index.swift | TencentLBS.framework | libz.1.2.5.tbd | | uni-video | uni-video-index.swift | DCUniVideo.xcframework、IJKMediaFrameworkWithSSL.xcframework、UniDCSVProgressHUD.xcframework | | | uni-push | uni-push-index.swift | GTCommonSDK.xcframework
GTSDK.xcframework
ZXSDK.framework | c++
resolv
z
sqlite3
MobileCoreServices
Security
SystemConfiguration
CoreTelephony
AVFoundation
UserNotifications
AdSupport | | uni-verify | uni-verify-index.swift
uni-network-index.swift | GTCommonSDK.xcframework
GeYanSdk.xcframework | resolv.9
c++
z
sqlite3.0、WebKit
CoreFoundation
Network
AdSupport | | uni-ad | uni-ad-index.swift | DCUniAdFoundation.xcframework | | | uni-facialRecognitionVerify | uni-facialRecognitionVerify-index.swift | AliyunFaceAuthFacade.framework
AliyunMobileRPC.framework
AliyunOSSiOS.framework
APBToygerFacade.framework
APPSecuritySDK.framework
BioAuthAPI.framework
BioAuthEngine.framework
deviceiOS.framework
DTFIdentityManager.framework
DTFSensorServices.framework
DTFUIModule.framework
DTFUtility.framework
MPRemoteLogging.framework
ToygerNative.framework
ToygerService.framework | c++
z
resolv
c++.1
c++abi
z.1.2.8
Accelerate
AssetsLibrary
QuartzCore
CoreFoundation
CoreLocation
ImageIO
CoreMedia
CoreMotion
AVFoundation
WebKit
AudioToolbox
CFNetwork
MobileCoreServices
SystemConfiguration
CoreTelephony
QuartzCore
CoreGraphics、AdSupport | | uni-cloud-client | uni-websocket-index.swift
uni-network-index.swift
uni-media-index.swift| DCloudMediaPicker.xcframework |AssetsLibrary
Photos
AVFoundation
CoreServices
CoreFoundation
CoreGraphics
CoreImage
GLKit
MetalKit
MobileCoreServices
QuartzCore
ImageIO
MediaPlayer
CoreText| | uni-crash | uni-crash-index.swift
uni-crash-UniCrashManager.swift | KSCrash.xcframework | | | uni-privacy | uni-privacy-index.swift | | | | uni-dialogPage | uni-dialogPage-index.swift
uni-dialogPage-native.swift | | | | uni-event | uni-event-index.swift
uni-event-native.swift | | | ### 配置uts-config.json(可选) 在`DCloudUTSExtAPI`工程中新建 `uts-config.json` 文件, `uni-video`模块需要添加如下配置 ``` { "components": [{ "name": "video", "class": "UTSSDKModulesDCloudUniVideoVideoComponent", "delegateClass": "VideoComponentRegister" }] } ``` `uni-push`模块需要添加如下配置 ``` { "hooksClasses": [ "UTSSDKModulesDCloudUniPushHookProxy" ] } ``` `uni-payment-alipay`模块需要添加如下配置 ``` { "hooksClasses": [ "UTSSDKModulesDCloudUniPaymentAlipayAlipayHookProxy" ], "providers": [{ "name": "alipay", "service": "payment", "class": "UTSSDKModulesDCloudUniPaymentAlipayUniPaymentAlipayProvider" }] } ``` `uni-payment-wxpay`模块需要添加如下配置 ``` { "hooksClasses": [ "UTSSDKModulesDCloudUniPaymentWxpayWxpayHookProxy" ], "providers": [{ "name": "wxpay", "service": "payment", "class": "UTSSDKModulesDCloudUniPaymentWxpayUniPaymentWxpayProvider" }] } ``` `uni-getLocation-systemy`模块需要添加如下配置 ``` { "providers": [{ "name":"system", "service":"location", "class":"UTSSDKModulesDCloudUniGetLocationSystemUniLocationSystemProviderImpl" }] } ``` `uni-getLocation-tencent`模块需要添加如下配置 ``` { "providers": [{ "name":"tencent", "service":"location", "class":"UTSSDKModulesDCloudUniGetLocationTencentUniLocationTencentProviderImpl" }] } ``` `uts-config.json`配置示例图 ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/utsconfig.png) ### 隐私清单 > 新建隐私清单:`Command + N`选择`App Privacy`点击`Next`,文件名称必须为`PrivacyInfo` 集成`uni-media`模块需要填写如下隐私清单 ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/unimedia_privacyinfo.png) 集成`uni-payment-wxpay`模块需要填写如下隐私清单 ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/uniwxpay_privacyinfo.png) ### 编译导出DCloudUTSExtAPI.xcframework 选择构建目标(Any iOS Device/Any iOS Simulator Device),在菜单栏中,选择`Product -> Build`(或使用快捷键`Command + B`),分别编译出真机以及模拟器的Framework文件。 在菜单栏中,选择`Product -> Show Build Floder in Finder` 获取编译产物所在路径。 使用xcodebuild命令行创建xcframework ``` xcodebuild -create-xcframework -framework 真机路径/DCloudUTSExtAPI.framework -framework 模拟器路径/DCloudUTSExtAPI.framework -output 导出路径/DCloudUTSExtAPI.xcframework ``` 导出成功后,将 `DCloudUTSExtAPI.xcframework` 添加到主工程,并设置为 `Embed && Sign` > `Apple芯片`的设备编译模拟器需要在菜单栏中点击 `Product -> Destination -> Show All Run Destinations` ,然后选择 `Rosetta模拟器` 编译 ## 主工程配置 根据资源文件中的`manifest.json`文件包含的模块名称,根据下述相关模块文档向`主工程`添加依赖以及工程配置 ## uni-prompt ### 添加依赖库以及资源文件 | 资源文件 | |---| | uni_uts_toast_error.png
uni_uts_toast_success.png | ## uni-canvas ### 添加依赖库以及资源文件 | 依赖库 | |---| | DCloudUniCanvas.xcframework`(Embed & Sign)` | ## uni-media ### 添加依赖库以及资源文件 | 依赖库 | 资源文件 | |---|---| | DCloudPermissionAlbum.xcframework
DCloudPermissionCamera.xcframework
DCloudPermissionMicrophone.xcframework | DCMediaEditingController.bundle
DCTZImagePickerController.bundle | ### Info.plist 添加`相机权限描述(NSCameraUsageDescription)`、`麦克风权限描述(NSMicrophoneUsageDescription)`、`相册读写权限描述(NSPhotoLibraryUsageDescription)`、`相册写权限描述(NSPhotoLibraryAddUsageDescription)` ``` NSCameraUsageDescription 需要您的同意,才能使用摄像头,以便于相机拍摄 NSMicrophoneUsageDescription 需要您的同意,才能使用麦克风,以便于录制音频 NSPhotoLibraryUsageDescription 需要您的同意,才能访问相册,以便于图像选取 NSPhotoLibraryAddUsageDescription 需要您的同意,才能访问相册,以便于保存图像 ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/unimedia_permission.png) ## uni-getLocation-system ### 添加依赖库以及资源文件 | 依赖库 | |---| | DCloudPermissionLocation.xcframework | ### Info.plist 添加`仅运行期间使用定位权限描述(NSLocationWhenInUseUsageDescription)`、`始终使用定位权限描述(NSLocationAlwaysAndWhenInUseUsageDescription)`、`使用临时位置权限描述(NSLocationTemporaryUsageDescriptionDictionary)` ``` NSLocationAlwaysAndWhenInUseUsageDescription 需要您的同意,才能访问位置信息 NSLocationWhenInUseUsageDescription 需要您的同意,才能在仅运行期间获取位置信息 NSLocationTemporaryUsageDescriptionDictionary YourPurposeKey 这里需要您临时授权高精度定位权限,一次临时授权时效仅app一个周期内, 每次硬启动都需要临时授权 ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/location_permission.png) ## uni-getLocation-tencent ### 添加依赖库以及资源文件 | 依赖库 | |---| | DCloudPermissionLocation.xcframework | ### Info.plist 1. 添加`仅运行期间使用定位权限描述(NSLocationWhenInUseUsageDescription)`、`始终使用定位权限描述(NSLocationAlwaysAndWhenInUseUsageDescription)`、`使用临时位置权限描述(NSLocationTemporaryUsageDescriptionDictionary)` ``` NSLocationAlwaysAndWhenInUseUsageDescription 需要您的同意,才能访问位置信息 NSLocationWhenInUseUsageDescription 需要您的同意,才能在仅运行期间获取位置信息 NSLocationTemporaryUsageDescriptionDictionary YourPurposeKey 这里需要您临时授权高精度定位权限,一次临时授权时效仅app一个周期内, 每次硬启动都需要临时授权 ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/location_permission.png) 2. 添加 `TencentLBSAPIKey` 配置项 ``` TencentLBSAPIKey 此处填写腾讯定位的ApiKey ``` ## uni-payment-alipay ### 添加依赖库以及资源文件 | 资源文件 | |---| | AlipaySDK.bundle | ### Info.plist 1. 添加 `白名单(LSApplicationQueriesSchemes)` ``` LSApplicationQueriesSchemes safepay alipay ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/alipay_queriesSchemes.png) 2. 添加 `URLSchemes(CFBundleURLTypes)`,`$appid_md5`建议使用`alipay`的`appid`的md5值 ``` CFBundleURLTypes CFBundleTypeRole Editor CFBundleURLName Alipay CFBundleURLSchemes alipay$appid_md5 ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/alipay_urlTypes.png) 3. 添加 `Alipay` 配置项 ``` Alipay universalLink 此处填写通用链接 ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/alipay_info.png) ### Capability `Target -> Signing & Capabilities` 点击 左上角`+ Capability `添加`Associated Domains`,将配置了 `Universal Links` 的域名加到 Domains 配置中 ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/associated_domains.png) ## uni-payment-wxpay ### Info.plist 1. 添加 `白名单(LSApplicationQueriesSchemes)` ``` LSApplicationQueriesSchemes weixin weixinULAPI weixinURLParamsAPI ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/wechat_queriesSchemes.png) 2. 添加 `URLSchemes(CFBundleURLTypes)` ``` CFBundleURLTypes CFBundleTypeRole Editor CFBundleURLName WeChat CFBundleURLSchemes 微信的appid ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/wechat_urltypes.png) 3. 添加 `WeChat` 配置项 ``` WeChat appid 此处填写微信的appid universalLink 此处填写微信开放平台注册的通用链接 ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/wechat_info.png) ### Capability `Target -> Signing & Capabilities` 点击 左上角`+ Capability `添加`Associated Domains`,将配置了 `Universal Links` 的域名加到 Domains 配置中 ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/associated_domains.png) ## uni-push ### 添加依赖库以及资源文件 | 依赖库 | |---| | DCloudPermissionPush.xcframework | ### Info.plist 1. 添加`通知权限描述(NSUserNotificationsUsageDescription)` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/unipush_permission.png) 2. 添加 `getui` 配置项 ``` getui appid 此处填写getui的appid appKey 此处填写getui的appKey appSecret 此处填写getui的appSecret ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/unipush_info.png) ### Capability `Target -> Signing & Capabilities` 点击 左上角`+ Capability `, 分别添加`Access Wi-Fi Information`、`Push Notifications`、`Time Sensitive Notifications` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/unipush_capability.png) ## uni-verify ### Info.plist 1. 添加 `geyan` 配置项 ``` geyan appid 此处填写geyan的appid ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/geyan_info.png) ## uni-facialRecognitionVerify ### 添加依赖库以及资源文件 | 依赖库 | 资源文件 | |---|---| | DCloudPermissionCamera.xcframework | APBToygerFacade.bundle
BioAuthEngine.bundle
ToygerNative.bundle | ### Info.plist 添加`相机权限描述(NSCameraUsageDescription)` ``` NSCameraUsageDescription 需要您的同意,才能使用摄像头,以便于相机拍摄 ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/camera_permission.png) ## uni-ad ### 基础广告(必须) #### 添加依赖库以及资源文件 | 依赖库 | 资源文件 | |---|---| | DCUniAdFoundation.xcframework`(Embed & Sign)` | DCUniAdSDK.bundle | #### Info.plist 进入[uni-ad后台](https://uniad.dcloud.net.cn/),复制首页中的联盟ID,将其添加到`uniapp-x` 节点下的 `unionid` 字段中 ``` uniapp-x unionid 广告联盟id,如未开通uniad可不填 ``` ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/uniappx_app_info.png) ### 增强广告-国内(可选) #### 添加依赖库以及资源文件 | 广告渠道 | 依赖库 | 资源文件 | 系统库 | |---|---|---|---| | 优量汇 | DCUniAdGdt.xcframework
libGDTMobSDK.a
DCloudPermissionIDFA.xcframework | | AppTrackingTransparency
AdSupport
CoreLocation
QuartzCore
SystemConfiguration
CoreTelephony
Security
StoreKit
AVFoundation
WebKit
JavaScriptCore
z
xml2
sqlite3
c++ | | Gromore | DCUniAdGm.xcframework
CSJMediation.xcframework
BUAdSDK.xcframework
DCloudPermissionIDFA.xcframework | CSJAdSDK.bundle | AppTrackingTransparency
Accelerate
AdSupport
AudioToolbox
AVFoundation
CoreGraphics
CoreImage
CoreLocation
CoreMotion
CoreMedia
CoreTelephony
CoreText
ImageIO
JavaScriptCore
MapKit
MediaPlayer
MobileCoreServices
QuartzCore
SystemConfiguration
Security
StoreKit
WebKit
DeviceCheck
z
xml2
sqlite3
c++
bz2
iconv
resolv.9
c++abi | | 快手 | DCUniAdKs.xcframework
DCloudPermissionIDFA.xcframework
KSAdSDK.xcframework`(Embed & Sign)` | | AppTrackingTransparency
AdSupport
MobileCoreServices
CoreGraphics
CoreData
CoreLocation
MediaPlayer
CoreMedia
WebKit
Accelerate
AVKit
MessageUI
QuickLook
AddressBook
CoreMotion
QuartzCore
SystemConfiguration
CoreTelephony
Security
StoreKit
AVFoundation
WebKit
z
resolv.9
sqlite3
c++
c++abi | | 百度 | DCUniAdBd.xcframework
DCloudPermissionIDFA.xcframework
BaiduMobAdSDK.framework | baidumobadsdk.bundle | AppTrackingTransparency
AdSupport
StoreKit
SafariServices
MessageUI
CoreMedia
CoreMotion
SystemConfiguration
CoreLocation
CoreTelephony
AVFoundation
Webkit
c++ | | sigmob | DCUniAdSgm.xcframework
DCloudPermissionIDFA.xcframework
WindSDK.xcframework
WindFoundation.xcframework | | AppTrackingTransparency
AdSupport
StoreKit
CFNetwork
CoreMedia
CoreGraphics
AVFoundation
CoreLocation
CoreTelephony
SafariServices
MobileCoreServices
WebKit
SystemConfiguration
ImageIO
z
sqlite3 | | 章鱼 | OctUniAdSDK.xcframework
DCloudPermissionIDFA.xcframework
OctCore.xcframework
OctAdSDK.xcframework | OctAdSDK.bundle
OctCore.bundle | AppTrackingTransparency
AdSupport
c++| ### 增强广告-国际(可选) #### 添加依赖库以及资源文件 | 广告渠道 | 依赖库 | 资源文件 | 系统库 | |---|---|---|---| | Google AdMob | DCUniAdGg.xcframework
DCloudPermissionIDFA.xcframework
UserMessagingPlatform.xcframework | | | | Pangle | PangleAdapter.xcframework
DCloudPermissionIDFA.xcframework
BURelyFoundation_Global.xcframework.xcframework
PAGAdSDK.xcframework | PAGAdSDK.bundle | StoreKit
MobileCoreServices
WebKit
MediaPlayer
CoreMedia
CoreLocation
AVFoundation
CoreTelephony
SystemConfiguration
AdSupport
CoreMotion
JavaScriptCore
DeviceCheck
resolv.9
c++
libc++abi
z
sqlite3 | | InMobi | InMobiSDK.xcframework
DCloudPermissionIDFA.xcframework
InMobiAdapter.xcframework | | sqlite3.0
z
WebKit| | IronSource | IronSource.xcframework
DCloudPermissionIDFA.xcframework
IronSourceAdapter.xcframework | | | | Liftoff | VungleAdsSDK.xcframework
DCloudPermissionIDFA.xcframework
LiftoffMonetizeAdapter.xcframework | | AdSupport
AudioToolbox
AVFoundation
CFNetwork
CoreGraphics
CoreMedia
MediaPlayer
QuartzCore
StoreKit
SystemConfiguration
z | | Mintegral | MintegralAdapter.xcframework
DCloudPermissionIDFA.xcframework
MTGSDK.xcframework
MTGSDKBanner.xcframework
MTGSDKBidding.xcframework
MTGSDKInterstitialVideo.xcframework
MTGSDKNativeAdvanced.xcframework
MTGSDKNewInterstitial.xcframework
MTGSDKReward.xcframework
MTGSDKSplash.xcframework | | | | UnityAds | UnityAds.xcframework
DCloudPermissionIDFA.xcframework
UnityAdapter.xcframework | | | > 集成Pangle、InMobi、IronSource、Liftoff、Mingetral、UnityAds渠道必须集成Google AdMob > 国际广告需要在[uni-AD后台](https://uniad.dcloud.net.cn/)后台审核通过之后才可以集成。审核通过之后可以连续客服获取国际广告SDK及配置。 #### Info.plist 添加`IDFA权限描述(NSUserTrackingUsageDescription)` ``` NSUserTrackingUsageDescription 获取标记权限向您提供更优质、安全的个性化服务及内容,未经同意我们不会用于其他目的;开启后,您也可以前往系统“设置-隐私 ”中随时关闭 ``` 开通 `Google AdMob` 渠道必须添加以下 ``` GADApplicationIdentifier 填写您的Google Admob 应用ID ``` 开通 `快手、sigmob、百度` 渠道建议添加以下权限描述 ![](https://web-ext-storage.dcloud.net.cn/native/doc/iOS/location_permission.png) #### 隐私清单 开通 `优量汇、Gromore` 渠道需要将该渠道的隐私清单内容手动合并到`主工程`的隐私清单文件中,详见目录`SDK/PrivacyInfo/优量汇`,`SDK/PrivacyInfo/Gromore`