开发环境

集成方式

下载的SDK中包含对应的示例工程，供大家参考

首先您需要一个 iOS 项目，已有项目或 新建一个 iOS App 项目，解压 SDK 包，将目录中的 UniMPSDK 文件夹 copy 到工程目录中， 然后按照以下步骤配置您的项目。

添加基础依赖库及资源文件

基础依赖库及资源是必须要引入到工程中的，基础依赖库及资源存放在 UniMPSDK/Core 目录中

UniMPSDK/Core 目录结构说明

  1. |-- UniMPSDK/Core
  2.     |-- Headers          // .h 头文件
  3.     |-- Libs             // 基础依赖库
  4.     |-- Resources        // 资源文件

添加基础依赖库

在 Xcode 项目左侧目录选中工程名，在 TARGETS->Build Phases-> Link Binary With Libaries 中点击“+”按钮，在弹出的窗口中点击 Add Other -> Add Files...，然后打开 UniMPSDK/Core/Libs 基础依赖库目录，选中目录中的 .a 库以及 .framework 库单击 open 按钮将依赖库添加到工程中

开发环境 - 图1 开发环境 - 图2

添加系统依赖库

接下来需要添加系统依赖库，在 Xcode 项目左侧目录选中工程名，在 TARGETS->Build Phases-> Link Binary With Libaries 中点击“+”按钮，在弹出的窗口中查找并选择所需的库（见下表），单击 “Add” 按钮，将库文件添加到工程中。

开发环境 - 图3

依赖的系统库
JavaScriptCore.framework CoreMedia.framework MediaPlayer.framework
AVFoundation.framework AVKit.framework GLKit.framework
OpenGLES.framework CoreText.framework QuartzCore.framework
CoreGraphics.framework libc++.tbd QuickLook.framework
CoreTelephony.framework AssetsLibrary.framework CoreLocation.framework
AddressBook.framework libiconv.tbd

添加依赖资源文件

接下来需要添加依赖资源文件，建议在项目中新建一个 Group，来管理资源文件，如示例在工程目录中创建的 UniMP 文件夹，然后按功能模块创建不同的目录存放资源文件； 添加资源文件方法：在左侧目录中选中导入资源文件的位置（示例中是 UniMP/Core），在右键菜单中选择Add Files to “工程名…”，然后打开 UniMPSDK/Core 目录，选择 Resources 文件夹，然后点击“Add”，将资源文件添加到工程中

开发环境 - 图4

添加 .h 头文件

在左侧目录中选中导入头文件的位置（示例中是 UniMP/Core），在右键菜单中选择Add Files to “工程名…”，然后打开 UniMPSDK/Core 目录，选择 Headers 文件夹，然后点击“Add”，将头文件资源添加到工程中

开发环境 - 图5

配置工程

在 Xcode 项目左侧目录选中工程名，在 TARGETS->Build Settings->Other Linker Flags 中添加 -ObjC 如下图

开发环境 - 图6

生成小程序应用资源

首先在 HBuilderX 中选择您的 uni-app 项目，如果没有请新建一个 uni-app 项目，如下图，创建 uni-app 项目

开发环境 - 图7

然后选中您的项目，右键->发行->原生App-制作应用wgt包 （注：HBuilderX 2.6.2 以下版本选项是 “原生App-制作移动App资源升级包”）

开发环境 - 图8

然后点击“浏览” 选择wgt包导出路径，点击 “生成wgt”

开发环境 - 图9

项目编译完成后会在控制台输出wgt包的路径，点击路径打开 wgt 资源包所在目录

开发环境 - 图10

开发环境 - 图11

如图，__UNI__11E9B73.wgt就是应用资源包，（__UNI__11E9B73 为小程序的 appid）

应用wgt资源文件可以选择从云端获取，也可以直接放到工程中使用，为了方便演示，示例工程将应用wgt资源文件添加到工程中使用

导入小程序应用资源

打开原生工程目录在 UniMP 路径中创建名称为Apps的文件夹，将之前导出的wgt包拷贝到Apps文件夹中，如下图

开发环境 - 图12

然后在原生工程中左侧目录中选中导资源文件的位置（示例中是 UniMP/），在右键菜单中选择Add Files to “工程名…”，然后打开工程目录，选择 Apps 文件夹，然后点击“Add”，将应用资源包添加到工程中，如下图所示；

开发环境 - 图13

代码实现

首先需要初始化 sdk engine，并设置启动参数，建议在 application:didFinishLaunchingWithOptions 方法中添加

在 AppDelegate.m 中引用头文件 #import "DCUniMP.h"

  1. - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  2.     // Override point for customization after application launch.
  4.     // 配置参数
  5.     NSMutableDictionary *options = [NSMutableDictionary dictionaryWithDictionary:launchOptions];
  6.     // 设置 debug YES 会在控制台输出 js log，默认不输出 log，注：需要引入 liblibLog.a 库
  7.     [options setObject:[NSNumber numberWithBool:YES] forKey:@"debug"];
  8.     // 初始化引擎
  9.     [DCUniMPSDKEngine initSDKEnvironmentWithLaunchOptions:options];
  11.     return YES;
  12. }

在 AppDelegate.m App 的生命周期方法中调用 SDK 相关方法

  1. #pragma mark - App 生命周期方法
  2. - (void)applicationDidBecomeActive:(UIApplication *)application {
  3.     [DCUniMPSDKEngine applicationDidBecomeActive:application];
  4. }
  6. - (void)applicationWillResignActive:(UIApplication *)application {
  7.     [DCUniMPSDKEngine applicationWillResignActive:application];
  8. }
  10. - (void)applicationDidEnterBackground:(UIApplication *)application {
  11.     [DCUniMPSDKEngine applicationDidEnterBackground:application];
  12. }
  14. - (void)applicationWillEnterForeground:(UIApplication *)application {
  15.     [DCUniMPSDKEngine applicationWillEnterForeground:application];
  16. }
  18. - (void)applicationWillTerminate:(UIApplication *)application {
  19.     [DCUniMPSDKEngine destory];
  20. }

根据项目需求，可以实现以下方法

  1. #pragma mark - 如果需要使用 URL Scheme 或 通用链接相关功能，请实现以下方法
  2. - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
  3.     // 通过 url scheme 唤起 App
  4.     [DCUniMPSDKEngine application:app openURL:url options:options];
  5.     return YES;
  6. }
  8. - (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
  9.     // 通过通用链接唤起 App
  10.     [DCUniMPSDKEngine application:application continueUserActivity:userActivity];
  11.     return YES;
  12. }

在您需要打开小程序的文件中添加以下逻辑（参考示例工程 ViewController.m ）

首先需要引用头文件

  1. #import "DCUniMP.h"

添加代理协议 DCUniMPEngineDelegate

  1. @interface ViewController () <DCUniMPSDKEngineDelegate>
  2. @end

小程序应用资源必须部署到指定的沙盒路径中才可以正常运行，请参考下面的方法

  1. /// 检查运行目录是否存在应用资源，不存在将应用资源部署到运行目录
  2. - (void)checkUniMPResource:(NSString *)appid {
  3. #warning 注意：isExistsUniMP: 方法判断的仅是运行路径中是否有对应的应用资源，宿主还需要做好内置wgt版本的管理，如果更新了内置的wgt也应该执行 installUniMPResourceWithAppid 方法应用最新的资源
  4.     if (![DCUniMPSDKEngine isExistsUniMP:appid]) {
  5.         // 读取导入到工程中的wgt应用资源
  6.         NSString *appResourcePath = [[NSBundle mainBundle] pathForResource:appid ofType:@"wgt"];
  7.         if (!appResourcePath) {
  8.             NSLog(@"资源路径不正确，请检查");
  9.             return;
  10.         }
  11.         // 将应用资源部署到运行路径中
  12.         NSError *error;
  13.         if ([DCUniMPSDKEngine installUniMPResourceWithAppid:appid resourceFilePath:appResourcePath password:nil error:&error]) {
  14.             NSLog(@"小程序 %@ 应用资源文件部署成功，版本信息：%@",appid,[DCUniMPSDKEngine getUniMPVersionInfoWithAppid:appid]);
  15.         } else {
  16.             NSLog(@"小程序 %@ 应用资源部署失败： %@",appid,error);
  17.         }
  18.     } else {
  19.         NSLog(@"已存在小程序 %@ 应用资源，版本信息：%@",appid,[DCUniMPSDKEngine getUniMPVersionInfoWithAppid:appid]);
  20.     }
  21. }

打开小程序应用

  1. /// 打开 uni 小程序
  2. - (IBAction)openUniMP:(id)sender {
  3.     // 初始化小程序的配置信息对象
  4.     DCUniMPConfiguration *configuration = [[DCUniMPConfiguration alloc] init];
  5.     [DCUniMPSDKEngine openUniMP:k_AppId configuration:configuration completed:^(DCUniMPInstance * _Nullable uniMPInstance, NSError * _Nullable error) {
  6.         if (uniMPInstance) {
  7.             // success
  8.         } else {
  9.             // error
  10.         }
  11.     }];
  12. }

实现代理方法

  1. #pragma mark - DCUniMPSDKEngineDelegate
  2. /// DCUniMPMenuActionSheetItem 点击触发回调方法
  3. - (void)defaultMenuItemClicked:(NSString *)appid identifier:(NSString *)identifier {
  4.     NSLog(@"标识为 %@ 的 item 被点击了", identifier);
  5. }
  7. /// 返回打开小程序时的自定义闪屏视图
  8. - (UIView *)splashViewForApp:(NSString *)appid {
  9.     UIView *splashView = [[[NSBundle mainBundle] loadNibNamed:@"SplashView" owner:self options:nil] lastObject];
  10.     return splashView;
  11. }

至此示例代码部分已完成，可以运行查看效果

tips

  • 集成遇到问题请先参考一下SDK目录中提供的demo工程，和查看一下 常见问题
  • 本篇示例只讲解了集成基础模块，其他功能模块集成请参考 内置功能模块集成
  • 小程序的一些使用技巧比如启动传参、启动直达二级页面等，更多 API 请参考 功能示例
  • 内置功能如不满足您的需求可以通过扩展原生能力来自行实现参考文档 iOS扩展原生能力
  • 欢迎加入 uni小程序SDK官方QQ 交流群：892918401

应用资源管理

uni小程序的应用资源集成方式

生成的 uni小程序 wgt 资源包可以部署到远程服务器动态下发也可以直接内置到工程中。然后通过 DCUniMPSDKEngine 类的installUniMPResourceWithAppid:resourceFilePath:password:error:方法传入wgt资源路径即可将wgt资源部署到运行路径。然后通过openUniMP:configuration:completed: 运行uni小程序应用。

uni小程序应用资源升级

  1. 宿主触发更新：宿主更新 wgt 可以选择从云端下载新的 wgt 资源包或在 App 升级时内置新的 wgt 包，然后调用 DCUniMPSDKEngine 类的installUniMPResourceWithAppid:resourceFilePath:password:error:方法传入 wgt 资源路径即可将wgt资源部署到运行路径，覆盖原有应用资源。 注意：宿主应对 wgt 资源包做好版本管理

  2. 小程序触发更新：小程序内下载新的wgt包，然后调用更新api应用新的wgt资源，具体请参考 wgt 资源在线升级/热更新

uni小程序应用删除

可通过 DCUniMPSDKEngine 类的 getUniMPRunPathWithAppid: 方法获取应用运行路径，删除应用资源即可；