全部产品

安装 mPaaS 插件

本文将引导您安装开发者工具,同时也向您介安装后加载 mPaaS 插件和重装 mPaaS 插件的相关操作。

mPaaS 插件失效声明

由于苹果系统安全策略的升级,从 macOS 10.15.1 版本开始加入了应用签名的强校验机制,去签名容易导致 Xcode 无法使用,甚至造成系统卡死。经过验证,在 macOS 10.15.3 及以上的系统使用 Xcode 11.3.1 及以上的版本时,安装去签名版本 mPaaS 插件会大概率出现系统卡死,恢复 Xcode 签名之后问题消失。基于以上原因,我们决定逐渐停止更新 iOS mPaaS 插件(去签名版本),并于 2020 年 9 月停止维护。

建议您尽快安装并使用新版本插件 mPaaS Xcode Extension。Extension 目前已经涵盖 mPaaS 插件的全部功能,并且增加了很多新特性,欢迎大家使用。

前置条件

  • 安装并打开了 Xcode,并完成了Xcode引导的相关基础工具的安装。
  • ruby 版本 ≥ 2.3.0。
  • 拥有sudo 权限。

操作步骤

安装 mPaaS 插件

  1. 完全退出 Xcode,然后在终端运行以下安装命令:

         
    1. sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/mpaaskit/install.sh)
  2. 按照屏幕提示输入密码。

  3. 去除 Xcode 签名。

    说明:Xcode 8 及以后版本对 mPaaS 插件的安装有限制,需要去除 Xcode 签名才能顺利安装 mPaaS 插件。步骤如下:

    1. 按照屏幕提示,输入 Y 同意去除 Xcode 签名。
    2. 选中希望去除签名的 Xcode 按下回车键继续。如果安装了多个 Xcode,请上下移动箭头进行选择。该操作同时会去掉 xcodebuild 的签名。

如果在安装过程中遇到问题,请参考 开发工具常见问题
如果需要恢复 Xcode 签名,或者想了解更多操作命令,请参考 命令行工具

加载 mPaaS 插件

完成以下步骤以加载 mPaaS 插件:

  1. 安装完开发者工具后,重启 Xcode。
  2. 在是否加载插件的弹框中,点击 Load Bundles

    load_bundle

    提示:如果意外点击了 Skip Bundles,您需要执行恢复命令,然后重启 Xcode,再选择 Load Bundles。恢复命令如下,您需要将 8.2.1 替换成实际的 Xcode 版本号:

          
    1. defaults delete com.apple.dt.Xcode DVTPlugInManagerNonApplePlugIns-Xcode-8.2.1
  3. 打开任意 Xcode 工程,点击 Edit > mPaaS > Main,若能看到如下主界面,则说明 mPaaS 插件加载成功:

    ios_mpaas_plugin_main.png

    重要:需先打开 Xcode 工程,再打开 Edit > mPaaS > Main,否则会因插件读取不到工程信息而报错。如果是打开 File > New > 新建 mPaaS 工程,则不需要先打开本机上的工程。

更新 Xcode 后重装 mPaaS 插件

如果您已经安装了开发者工具,那么更新 Xcode 之后,您可以按照如下步骤重装 mPaaS 的 Xcode 插件:

  1. 执行命令 mpaas --version 查看开发者工具的版本;若执行失败请尝试 mpaas version 命令。
  2. 若为 5.0.0 及以上版本,则执行命令 mpaas xcode plugins install 重装 mPaaS 插件;否则请参照上文重新安装开发者工具。

相关链接