Weex SDK 集成到工程

CocoaPods 引入 Weex iOS SDK到工程

可以通过源码编译出Weex SDK，可以在新的feature 或者bugfix 分支，尝试最新的feature。

假设你已经完成了安装iOS 开发环境和 CocoaPods。

1. 从github获取源码

git clone https://github.com/alibaba/weex.git

2. 把WeexSDK 导入到你已有的项目，如果没有，可以参考新建项目

拷贝 ios/sdk下面目录到你的项目目录，在添加依赖之前，确保项目目录有Podfile，如果没有，创建一个，用文本编辑器打开，添加如下依赖：

 target 'YourTarget' do
     platform :ios, '7.0' 
     pod 'WeexSDK', :path=>'./sdk/'   # pod 'WeexSDK', '0.6.1'
 end

如果使用正式版本如 0.6.1 的，就不需要做拷贝ios/sdk 这个操作，直接引用cocoaPods的master repo 上就可以，这个需要在Podfile 最前面添加

source 'https://github.com/CocoaPods/Specs.git'

在命令行（terminal）中，切换到当前目录，运行 pod install，过一会，项目的.workspace结尾的文件就被创建出来，到这步，依赖已经添加完。

3. 初始化 Weex 环境

在AppDelegate.m 文件中做初始化操作，一般会在didFinishLaunchingWithOptions方法中如下添加

//business configuration
[WXAppConfiguration setAppGroup:@"AliApp"];
[WXAppConfiguration setAppName:@"WeexDemo"];
[WXAppConfiguration setAppVersion:@"1.0.0"];

//init sdk enviroment   
[WXSDKEngine initSDKEnviroment];

//register custom module and component，optional
[WXSDKEngine registerComponent:@"MyView" withClass:[MyViewComponent class]];
[WXSDKEngine registerModule:@"event" withClass:[WXEventModule class]];

//register the implementation of protocol, optional
[WXSDKEngine registerHandler:[WXNavigationDefaultImpl new] withProtocol:@protocol(WXNavigationProtocol)];

//set the log level    
[WXLog setLogLevel:WXLogLevelVerbose];

4. 渲染 Weex Instance

Weex 支持整体页面渲染和部分渲染两种模式，你需要做的事情是用指定的URL渲染weex的view，然后添加到它的父容器上，父容器一般都是viewController

#import <WeexSDK/WXSDKInstance.h>

- (void)viewDidLoad 
{
    [super viewDidLoad];

    _instance = [[WXSDKInstance alloc] init];
    _instance.viewController = self;
    _instance.frame = self.view.frame; 

    __weak typeof(self) weakSelf = self;
    _instance.onCreate = ^(UIView *view) {
        [weakSelf.weexView removeFromSuperview];
        [weakSelf.view addSubview:weakSelf.weexView];
    };

    _instance.onFailed = ^(NSError *error) {
        //process failure
    };

    _instance.renderFinish = ^ (UIView *view) {
        //process renderFinish
    };
    [_instance renderWithURL:self.url options:@{@"bundleUrl":[self.url absoluteString]} data:nil];
}

WXSDKInstance 是很重要的一个类，提供了基础的方法和一些回调，如renderWithURL、onCreate、onFailed等，可以查看 WXSDKInstance.h的声明。

5. 销毁 Weex Instance

在 viewController的 dealloc 阶段销毁掉weex instance，释放内存，避免造成内存泄露。

- (void)dealloc
{
    [_instance destroyInstance];
}

6. 导入 Weex SDK framework到工程

参考此处直接导入weexSDK。

接入iOS