在iOS开发中，有时我们需要将已有的原生（Native）工程与Web技术相结合，以便实现更灵活、高效的用户界面和交互。在这种情况下，WeexSDK是一个值得考虑的解决方案。Weex是由Alibaba开源的一个高性能、跨平台的移动端开发框架，它允许开发者用一套代码（主要是JavaScript）来编写原生应用，支持iOS、Android以及H5平台。本教程将详细介绍如何在原有的iOS Native工程中集成WeexSDK，并提供一个简单的示例项目——weexPageDemo-master。
**一、WeexSDK简介**
Weex的核心理念是“Write Once，Run Everywhere”，通过JavaScript来驱动原生组件，实现了前端和后端的解耦。其主要特点包括：
1. **高性能**：Weex使用原生渲染引擎，避免了WebView性能瓶颈。
2. **组件化**：Weex提供了丰富的原生组件，如布局、图像、文本等，可进行灵活组合。
3. **热更新**：支持JS代码的热更新，无需重新安装应用即可实现功能更新。
4. **跨平台**：支持iOS、Android和H5，方便多平台开发。
**二、集成步骤**
1. **环境准备**
- Xcode：确保你已经安装了最新版本的Xcode。
- CocoaPods：安装并配置CocoaPods作为iOS项目的依赖管理工具。
2. **创建Podfile**
在你的项目根目录下创建一个Podfile，添加以下内容：
```
platform :ios, '9.0'
target 'YourProjectName' do
pod 'WeexSDK', '~> 0.26.0'
end
```
这里`0.26.0`是你选择的WeexSDK版本，根据实际需求进行调整。
3. **执行Pod安装**
打开终端，进入项目根目录，运行`pod install`命令安装WeexSDK。
4. **导入WeexSDK**
安装完成后，打开`.xcworkspace`文件继续开发，导入WeexSDK头文件：
```objc
#import <WeexSDK/WeexSDK.h>
```
5. **初始化Weex实例**
在`AppDelegate.m`的`- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions`方法中，初始化Weex实例：
```objc
[WXAppConfiguration setAppKey:@"your_app_key"];
[WXSDKEngine initializeWithConfig:@{@"debug": @YES}];
```
`your_app_key`替换为你的应用标识，`debug`参数设置为`@YES`表示开启调试模式。
6. **加载Weex页面**
在需要展示Weex页面的地方，例如`ViewController.m`，创建并注册组件：
```objc
WXSDKInstance *instance = [[WXSDKInstance alloc] init];
instance.pageName = @"your_entry_file";
instance.userInfo = @{@"key":@"value"}; // 可选，用于传递数据到JS
instance.entryURL = [[NSBundle mainBundle] URLForResource:@"your_entry_file" withExtension:@"js"];
[instance renderWithCompletionBlock:nil];
[instance registerModule:@"your_module" withClass:NSClassFromString(@"YourModuleClassName")]; // 注册自定义模块
[instance registerComponent:@"your_component" withClass:NSClassFromString(@"YourComponentClassName")]; // 注册自定义组件
[instance fireEvent:@"instanceId" params:@{@"event":@"load"}]; // 可选，用于触发JS事件
[instance viewDidLoad];
```
7. **处理页面生命周期**
你需要在`ViewController`中处理Weex页面的生命周期方法，例如：
```objc
- (void)viewWillAppear:(BOOL)animated {
[super viewWillAppear:animated];
[instance viewWillAppear:animated];
}
- (void)viewWillDisappear:(BOOL)animated {
[super viewWillDisappear:animated];
[instance viewWillDisappear:animated];
}
- (void)viewDidDisappear:(BOOL)animated {
[super viewDidDisappear:animated];
[instance viewDidDisappear:animated];
}
```
8. **构建JS代码**
创建对应的JS文件，例如`your_entry_file.js`，编写Weex页面逻辑。可以使用Weex提供的组件和API来构建界面和交互。
**三、weexPageDemo-master项目**
这个示例项目`weexPageDemo-master`应该包含了一个已经集成WeexSDK的iOS工程，以及一些示例Weex页面的JS文件。你可以通过查阅它的源码来理解上述集成步骤的具体实现。在运行项目后，可以看到Weex页面在原生iOS应用中的效果。
集成WeexSDK到原有的iOS Native工程中，能够让你利用JavaScript进行快速的界面开发，同时享受原生应用的性能和体验。通过学习和实践，你可以掌握如何将WeexSDK与现有项目融合，提高开发效率，实现更加动态和灵活的应用。
