iOS 源码的构建和运行

更新时间：2019-06-17 23:35:34

Step 1. 安装 CocoaPods

iOS 源码的依赖使用 CocoaPods 进行管理，因此首先要在本地安装和配置好 CocoaPods，可以参见 Using CocoaPods。

1.1 安装 Ruby 环境

CocoaPods 是使用 Ruby 实现的，可以通过 gem 命令来安装。Mac 中一般自带 Ruby 环境，如果没有请参考 Ruby 官方文档 来安装 Ruby 环境。

强烈建议将默认的 RubyGems 源替换为 Ruby China 的 RubyGems 镜像，这样国内访问速度要快很多，更多信息可以参考 RubyGems 镜像 - Ruby China。

sudo gem sources -a https://gems.ruby-china.com/
sudo gem sources --remove https://rubygems.org/

1.2 安装 CocoaPods

目前移动工作台推荐使用的 CocoaPods 版本是 1.5.3 ，使用以下命令安装 1.5.3 的 CocoaPods：

sudo gem update
sudo gem install cocoapods -v 1.5.3
pod setup

pod setup 可能会比较慢，请耐心等待

Step 2. 安装 Xcode

Xcode 是苹果提供的集成开发环境（IDE），可以通过 Xcode 来构建 iOS 源码。点击 “下载和安装 Xcode”。

Step 3. 获取源码包

通过移动应用工作台下载源码包：

下载下来的源码结构如下：

Step 4. 构建和运行

4.1 安装源码依赖

打开工程根目录 project_source，执行 pod install --repo-update 安装源码依赖，执行成功将会看到如下几行输出：

➜ project_source pod install

@repo_update

Analyzing dependencies

Fetching podspec for ...

...

no env sources

Downloading dependencies

Installing ...

...

Generating Pods project

Integrating client project

[!] Please close any current Xcode sessions and use IMSLinkDevelopUniversalApp.xcworkspace for this project from now on.

Sending stats

Pod installation complete! There are 30 dependencies from the Podfile and 44 total pods installed.

按照提示执行 open IMSLinkDevelopUniversalApp.xcworkspace 打开工程

4.2 构建和运行

如果你没有 “苹果开发者账号” 可以通过模拟器来运行和体验

注意：模拟器无法进行消息推送

Step 5. 更多操作

• 真机调试

• 证书权限

  • 可视化应用构建依赖权限如下：
    • 设备模块依赖：Access WiFi Information

- 消息模块依赖：Push Notifications

• 真机调试时需开启相应的证书权限
  • 先登录 Apple ID 账号（ Xcode -> Preferences），点击左下角“+”号按钮，选择 Apple ID，输入注册的苹果开发者账号

- 选择 Automatically manage singing，开启证书权限

• App 分发（如，通过 TestFlight 进行 Beta 测试，上架 AppStore）