# iOS 集成

>注：以下文档都是假设您已经具备一定的iOS开发经验。

这篇教程，讲述了如何将 Hippy 集成到 iOS 工程。

# 集成到自定义工程中

## 使用pod集成

1. 安装 [CocoaPods](https://cocoapods.org/)，Hippy iOS SDK [版本查询](https://cocoapods.org/pods/hippy)

2. 在用户自定义工程目录下创建podfile文件，文本如下

    ```text
    #保持pod文件目录结构
    install! "cocoapods", :preserve_pod_file_structure => true
    platform :ios, '8.0'
    #TargetName替换成用户工程名
    target TargetName do
        #使用hippy最新版本
        pod 'hippy'
        #若想指定使用的hippy版本号，比如2.0.0版，请使用
        #pod 'hippy', '2.0.0'
    end
    ```

3. 在命令行中执行命令

    ```text
    pod install
    ```

4. 使用 cocoapods 生成的 `.xcworkspace` 后缀名的工程文件来打开工程。

## 使用源码直接集成

1. 从GitHub中将ios源码下载，将ios/sdk文件夹以及core文件夹拖入工程中

2. 删除对 `core/js` 文件夹的引用。

   > core/js文件夹中包含的是不参与编译的js文件

3. 删除对 `core/napi/v8` 文件夹的引用

   > core 文件夹代码涉及 ios/adr JS引擎，ios使用的JSC

4. 在 `xcode build settings` 中设置 *User Header Search Paths* 项为core文件夹所在路径

 > 假设core文件夹路径为 `~/documents/project/hippy/demo/core`，那应当设置为 `~/documents/project/hippy/demo/` 而不是 `~/documents/project/hippy/demo/core`

# 编写代码开始调试或者加载业务代码

Hippy 提供分包加载接口以及不分包加载接口, 所有的业务包都是通过 HippyRootView 进行承载，创建业务也就是创建 RootView。

目前HippyRootView提供分包加载接口以及不分包加载接口

## 使用分包加载接口

``` objectivec
/** 此方法适用于以下场景：
 * 在业务还未启动时先准备好JS环境，并加载包1，当业务启动时加载包2，减少包加载时间
 * 我们建议包1作为基础包，与业务无关，只包含一些通用基础组件，所有业务通用
 * 包2作为业务代码加载
*/

//先加载包1地址，创建执行环境
//commonBundlePath值包1路径
NSURL * commonBundlePath = getCommonBundlePath();
HippyBridge *bridge = [[HippyBridge alloc] initWithBundleURL: commonBundlePath
                                                moduleProvider: nil
                                                launchOptions: nil];

// 通过bridge以及包2地址创建rootview
- (instancetype)initWithBridge:(HippyBridge *)bridge  
    businessURL:(NSURL *)businessURL // 业务包地址
    moduleName:(NSString *)moduleName // 业务包启动函数名
    initialProperties:(NSDictionary *)initialProperties // 初始化参数
    shareOptions:(NSDictionary *)shareOptions  // 配置参数（进阶）
    isDebugMode:(BOOL)isDebugMode // 是否是调试模式
    delegate:(id<HippyRootViewDelegate>)delegate // rootview加载回调

```

## 使用不分包加载接口

``` objectivec
- (instancetype)initWithBundleURL:(NSURL *)bundleURL  // 包地址
    moduleName:(NSString *)moduleName // 业务包启动函数名
    initialProperties:(NSDictionary *)initialProperties  // 初始化参数
    shareOptions:(NSDictionary *)shareOptions // 配置参数（进阶）
    isDebugMode:(BOOL)isDebugMode // 是否是调试模式
    delegate:(id <HippyRootViewDelegate>)delegate // rootview加载回调
```

!> 不管使用分包还是不分包初始化 rootview, 如果 **isDebugMode** 为YES的情况下，会忽略所有参数，直接使用 npm 本地服务加载测试 bundle。使用分包加载可以结合一系列策略，比如提前预加载bridge, 全局单bridge等来优化页面打开速度。