【uni-app】iOS平台原生插件开发

本文介绍: 由于uni–app 官方使用工程依赖的形式去集成原生插件，流程有点复杂，对不熟悉iOS开发的道友不够友好。于是，基于 cocoapods的集成方案应运而生。本方案的目的在于简化集成流程，让没有 iOS开发经验的道友能够快速集成并使用原生插件。……

阅读此文档的过程中遇到任何问题，请关注公众号【`移动端Android和iOS开发技术分享`】或加QQ群【`309580013`】

由于uni–app 官方使用工程依赖的形式去集成原生插件，流程有点复杂，对不熟悉iOS开发的道友不够友好。于是，基于 cocoapods的集成方案应运而生。本方案的目的在于简化集成流程，让没有 iOS开发经验的道友能够快速集成并使用原生插件。

下载SDK[https://pan.baidu.com/s/1Ex tRytSAuOpGjl4e4m9Hdw?pwd=r v dy]并解压SDK到指定目录。解压后的目录结构如下图：

进入 co de/SDK/HBuilde r–uniPluginDemo 目录，创建Pod file 文件，文件内容如下

# 最低支持iOS10
platform :ios, '10.0'	

# 忽略所有警告
inhibit_all_warnings!

target 'HBuilder' do
  use_frameworks!
	
end

# 关闭bitcode
post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['ENABLE_BITCODE'] = 'NO'
    end
  end
end

然后打开终端依次执行以下命令：

cd ~/code/SDK/HBuilder-uniPluginDemo
pod install

cd ~/code/SDK
pod lib create WITTestUniPlugin

What platform do you want to use?? [ iOS / macOS ]
 &gt; iOS

What language do you want to use?? [ Swift / ObjC ]
 &gt; ObjC

Would you like to include a demo application with your library? [ Yes / No ]
 &gt; No

Which testing frameworks will you use? [ Specta / Kiwi / None ]
 &gt; None

Would you like to do view based testing? [ Yes / No ]
 &gt; No

What is your class prefix?
 &gt; WIT

打开code/SDK/HBuilder–uniPluginDemo 目录的Pod file文件，并增加代码pod 'WITTestUniPlugin', :path=>'./WITTestUniPlugin'到如下位置：

# 最低支持iOS10
platform :ios, '10.0'	

# 忽略所有警告
inhibit_all_warnings!

target 'HBuilder' do
  use_frameworks!

  pod 'WITTestUniPlugin', :path=>'../WITTestUniPlugin'
end

# 关闭bitcode
post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['ENABLE_BITCODE'] = 'NO'
    end
  end
end

cd ~/code/SDK/HBuilder-uniPluginDemo
pod install

双击code/SDK/HBuilder-uniPluginDemo/HBuilder-uniPlugin.xc workspace文件后，会打开原生项目。依次展开左侧的目录树Pods -> Development Pods -> WITTestUniPlugin。在ReplaceMe.m文件的位置新建WITTestUniModule类。然后打开文件，并在最后一行代码的前面插入如下代码

  s.static_framework = true

  s.xcconfig = {
    'USER_HEADER_SEARCH_PATHS' => [
      '"$(SRCROOT)/../../SDK/inc/DCUni"',
      '"$(SRCROOT)/../../SDK/inc/weexHeader"'
    ]
  }

#import <Foundation/Foundation.h>
#import "DCUniModule.h"

NS_ASSUME_NONNULL_BEGIN

@interface WITTestUniModule : DCUniModule

@end

NS_ASSUME_NONNULL_END

#import "WITTestUniModule.h"
#import "DCUniDefine.h"

@implementation WITTestUniModule


// 通过宏 UNI_EXPORT_METHOD 将异步方法暴露给 js 端
UNI_EXPORT_METHOD(@selector(testAsyncFunc:callback:))

// 通过宏 UNI_EXPORT_METHOD_SYNC 将同步方法暴露给 js 端
UNI_EXPORT_METHOD_SYNC(@selector(testSyncFunc:))

/// 异步方法（注：异步方法会在主线程（UI线程）执行）
/// @param options js 端调用方法时传递的参数   支持：String、Number、Boolean、JsonObject 类型
/// @param callback 回调方法，回传参数给 js 端   支持： NSString、NSDictionary（只能包含基本数据类型）、NSNumber 类型
- (void)testAsyncFunc:(NSDictionary *)options callback:(UniModuleKeepAliveCallback)callback {

    // options 为 js 端调用此方法时传递的参数 NSLog(@"%@",options); // 可以在该方法中实现原生能力，然后通过 callback 回调到 js

   if (callback) {
       // 第一个参数为回传给js端的数据，第二个参数为标识，表示该回调方法是否支持多次调用，如果原生端需要多次回调js端则第二个参数传 YES;
        callback(@"success",NO);
    }
}

/// 同步方法（注：同步方法会在 js 线程执行）
/// @param options js 端调用方法时传递的参数   支持：String、Number、Boolean、JsonObject 类型
- (NSString *)testSyncFunc:(NSDictionary *)options {
    // options 为 js 端调用此方法时传递的参数
    NSLog(@"%@",options);

    /*
     可以在该方法中实现原生功能，然后直接通过 return 返回参数给 js
     */

    // 同步返回参数给 js 端  支持：NSString、NSDictionary（只能包含基本数据类型）、NSNumber 类型
    return @"success";
}

@end

cd ~/code/SDK/HBuilder-uniPluginDemo
pod install

然后按下图流程操作，并获取到WITTestUniPlugin.framework文件夹

d.在WITTestUniPlugin文件夹里新建ios文件夹，并把WITTestUniPlugin.framework文件放到该目录

{
    "name":"WITTestUniPlugin",
    "id":"WITTestUniPlugin",
    "version":"0.1.0",
    "description":"iOS原生插件",
    "_dp_type":"nativeplugin",
    "_dp_nativeplugin":{
        "ios":{
            "plugins":[
                {
                    "type":"module",
                    "name":"WITTestUniPlugin",
                    "class":"WITTestUniModule"
                }
            ],
            "integrateType":"framework",
            "deploymentTarget":"10.0",
            "frameworks":[
                "Foundation.framework",
                "UIKit.framework"
            ]
        }
    }
}