本文讲述iOS项目集成WeexSDK、WXDevtool、GCanvas等;也将介绍native如何与Weex通讯
在iOS工程中集成FrameWork无外乎两种,第一,项目支持cocoaPods,采用cocoaPods 集成 Weex iOS SDK到你的项目;第二,源码集成,优势在于可以修改WeexSDK,打包生成你自己定制的Weex SDK。 两种方式官网都提供了参考,虽然有些乱七八糟。
前期只是为了学习,没有深入学习Weex SDK源码,采用cocoaPods集成,首先确保你的cocoaPods版本为较新版本。
pod search WeexSDK
打开命令行,切换到你已有项目 Podfile 这个文件存在的目录,执行pod init;用文本编辑器打开Podfile文件,添加如下内容
source 'git@github.com:CocoaPods/Specs.git'
target 'YourTarget' do
platform :ios, '7.0'
pod 'WeexSDK', '0.12.0' ## 建议使用WeexSDK新版本
end
# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
source 'git@github.com:CocoaPods/Specs.git'
target 'WeexStudyDemo' do
# Uncomment the next line if you're using Swift or would like to use dynamic frameworks
# use_frameworks!
# Pods for WeexStudyDemo
platform :ios, '7.0'
pod 'WeexSDK', '0.12.0' ## 建议使用WeexSDK新版本
pod 'SDWebImage', '4.0.0'
pod 'SocketRocket', '0.5.1'
pod 'WXDevtool', '0.9.5'
end
4、安装依赖 执行 pod install,没有出现任何错误表示已经完成环境配置。
SDK导入完成。
为了便于扩展,我创建了一个PFWeexDefine存放Weex的宏;创建了PFWeexManager文件管理Weex;PFWeexViewController作为Weex页面容器。 1、在PFWeexDefine中导入框架头文件
#ifdef EnableWeexSDK
#import <WeexSDK/WeexSDK.h>
#import <WeexSDK/WXSDKInstance.h>
#import <WeexSDK/WXSDKEngine.h>
#import <WeexSDK/WXUtility.h>
#import <WeexSDK/WXDebugTool.h>
#import <WeexSDK/WXSDKManager.h>
#import <WeexSDK/WXEventModuleProtocol.h>
#import <WeexSDK/WXModuleProtocol.h>
#import <TBWXDevTool/WXDevTool.h>
#endif
2、在PFWeexManager创建单例,管理WeexSDK,初始化Weex环境 在 AppDelegate.m 文件中使用PFWeexManager,一般会在 didFinishLaunchingWithOptions 方法中添加。
- (void)initWeexSDK {
#ifdef EnableWeexSDK
//1.1 设置组织
[WXAppConfiguration setAppGroup:@"PFWeex"];
//1.2 设置App的名称
[WXAppConfiguration setAppName:@"WeexStudyDemo"];
//1.3 设置App的版本号
[WXAppConfiguration setAppVersion:AppVersion];
//2. 初始化`WeexSDK`环境
[WXSDKEngine initSDKEnvironment];
//3. 注册自定义的组件和模型(可选) [如果有就注册如果没有就不注册]
//register custom module and component,optional
//[WXSDKEngine registerComponent:@"YourView" withClass:[MyViewComponent class]];
//[WXSDKEngine registerModule:@"YourModule" withClass:[YourModule class]];
//4. 注册协议的实现,可选
//[WXSDKEngine registerHandler:[WXNavigationDefaultImpl new] withProtocol:@protocol(WXNavigationProtocol)];
//5. 设置日志的级别(默认的日志级别是Info)
[WXLog setLogLevel:WXLogLevelDebug];
#endif
}
注意,在之前SDK中初始化WeexSDK
环境,方法名为initSDKEnviroment,这是Weex团队拼写错误,后来废弃,替换成initSDKEnvironment。学好英语真的很重要?
3、渲染 weex Instance weex支持两种渲染模式,一种是整个界面,一种是界面某一部分。你需要给需要渲染的weex视图指定特定的URL,然后把它添加到父控件中。在实际开发中全页面渲染更有意义,前面创建的PFWeexViewController就是继承于UIViewController。PFWeexViewController作为基础页面,需要考虑各种交互:比如手势返回等,在此不做深入延伸。
4、销毁 Weex Instance 在 viewController 的 dealloc 阶段 销毁掉 Weex instance,释放内存,避免造成内存泄露。
- (void)dealloc {
[_instance destroyInstance];
}
开始研究WeexSDK for iOS,当然官方文档先学习一下。对于Weex的使用,就是针对具体的业务场景实现Handler、Module、Component。
/**
* @abstract Fire an event to the component and tell Javascript which value has been changed.
* @param eventName 事件名称,可以在weex文件某个标签组件监听,命名规范为 onXXX
* @param params 数据
* @param domChanges 发生改变的数据
**/
- (void)fireEvent:(NSString *)eventName params:(NSDictionary *)params domChanges:(NSDictionary *)domChanges
多用于 Module 回调结果给 js,回调类型分为下面两种: WXModuleCallback 为了性能考虑,该回调只能回调通知js一次,之后会被释放,多用于一次结果 WXModuleKeepAliveCallback 该回调可以设置是否为多次回调类型,多次回调的场景如持续监听位置的变化,并返回给 js。
@implementation WXEchoModule
@synthesize weexInstance; // 让该module 获得当前instance
WX_EXPORT_METHOD(@selector(echo:))
- (void)echo:(NSString *)param callback:(WXModuleKeepAliveCallback)callback
{
callback(param,ture);// 此处设置true,该回调function 可以多次回调执行,可以写循环测试.
}
图片下载 handler。Weex 会把需要设置图片的 View 和 URL 透露出来,Native 端需要实现这个接口进行图片下载。WeexSDK kernel 本身没有提供图片下载的默认实现。
是一个用来记录App配置信息的单例对象
初始化SDK,具体有四个步骤: 1、WXMonitor
Weex 开发了一套 Weex Devtools,它与 Chrome Devtools 极为相似,学习成本很低,目前只支持在 Chrome 浏览器里使用。在终端输入weex debug指令(最新版本 starter kit 添加了 npm run debug 支持),会弹出 Weex Devtools,打开 Playground,扫描 Devtools 的二维码来启动 Debugger。 这块讲解起来比较繁杂,需要在使用过程中摸索,饿了么讲解的不错传送门;github上也有也经典讲解https://github.com/weexteam/article/issues/50。
Weex支持的属性真的太少太少太少,一不留神就可能会掉到坑了,项目中有个圆形进度条需求,用客户端分分钟开发的事,用Weex无法实现(也可能自身太菜),后来用Vue写出来一个,拿到Weex上依然不兼容(喷了一口老血),后来没办法,采用GCanvas,虽出来效果,但是毛边严重,但是一些基础绘图还是支持不错。