diff --git a/docs/plugin/uts-plugin.md b/docs/plugin/uts-plugin.md index d0d506d99d29b0c9640448b40be4c9a8d1646a84..f6ce04f06c96f951438c1fa2f24f49c9977f516e 100644 --- a/docs/plugin/uts-plugin.md +++ b/docs/plugin/uts-plugin.md @@ -488,9 +488,14 @@ getBatteryCapacity() 若HBuilderX中没有`uts编译运行插件`，在第一次运行时会自动下载。 +#### Android平台 + - Android上，运行体验与uni-app基本无差异。一样可以热刷新，打印console.log。 -- iOS上，uts插件暂不支持热刷新，真机需提交云端打包生成[自定义基座](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#customplayground)才能生效 +#### iOS平台 + +- HBuilderX 3.6.9以下版本，uts插件不支持热刷新，真机需提交云端打包生成[自定义基座](https://uniapp.dcloud.net.cn/tutorial/run/run-app.html#customplayground)才能生效 +- HBuilderX 3.6.9+，uts插件，支持本地编译和真机运行 [详情](https://uniapp.dcloud.net.cn/tutorial/run/uts-development-io.html) ### 5.2 自定义基座 diff --git a/docs/tutorial/run/uts-development-ios.md b/docs/tutorial/run/uts-development-ios.md new file mode 100644 index 0000000000000000000000000000000000000000..80430c48b8a578d832ad252dd062f8f061b0aaec --- /dev/null +++ b/docs/tutorial/run/uts-development-ios.md @@ -0,0 +1,29 @@ +# iOS UTS扩展开发 + +> 版本要求: HBuilderX 3.6.9+ + +HBuilderX 3.6.9+，新增 uts插件 iOS平台 支持本地编译和真机运行，需要配置Xcode环境。 + +当您运行带有uts插件的项目到`iOS真机设备`时，会自动安装【uts开发扩展 - iOS】插件，请务必安装。具体如下： + + + +如果您在本地修改uts插件`app-ios`代码，HBuilderX支持在本地编译并真机运行到iOS设备，而无需再提交代码到云端制作自定义基座。 + +此功能依赖[Xcode](#Xcode环境配置)。 + + + +## Xcode环境配置 + +本地真机运行 `uts插件` 目前需要`Xcode 13.2.1` 或更高版本。 + +你可以通过 `App Store` 或是到[Apple 开发者官网上下载](https://developer.apple.com/xcode/downloads/ank)。这一步骤会同时安装 `Xcode IDE`、`Xcode` 的命令行工具和 `iOS` 模拟器。 + +#### Xcode 的命令行工具 + +启动 `Xcode`，并在`Xcode | Settings(Xcode14之前叫 Preferences) | Locations`菜单中检查一下是否装有某个版本的`Command Line Tools`。`Xcode` 的命令行工具中包含一些必须的工具，比如`git`等。 + +![Command Line Tools](https://native-res.dcloud.net.cn/images/uts/iOS/xcode_command_line_tool.jpeg) + +请在使用uts插件真机运行 之前确保你本地的环境 如上图一样 准备完毕。 \ No newline at end of file