我的书签
添加书签
移除书签APICloud Studio WiFi真机同步和WiFi真机预览使用说明
概述
WiFi真机同步，通过在Studio中建立调试服务，接收真机设备主动连接调试的方式，配合apploader及自定义loader，为开发者提供在局域网内通过WiFi实现应用快速真机同步和实时预览的服务，摆脱应用开发调试过程中，真机同步时必须依赖USB数据线的困扰，完美解决了USB数据线真机同步方式存在的各种问题，具有更强的稳定性和兼容性。WiFi真机同步支持一对多的同步，即同一个项目可同时同步到多个真机；WiFi真机的同步策略为“增量”策略，即每次同步仅同步被编辑过的文件，因此同步速度非常快，基本上可以达到“秒同”；
WiFi真机实时预览，提供在真机上实时加载运行指定页面并预览效果的功能，支持对包括模块在内的所有端API的调试和预览。
使用流程
使用前，要使电脑和手机连接的是同一个WiFi。
1、项目根目录右键 —> “WIFI 真机同步 IP 和端口”：
2、您将查看到Studio在本地建立的调试服务地址及端口：
3、打开您手机上的AppLoader或自定义loader（如果手机上还未安装最新版AppLoader，请先安装最新版AppLoader，），最新版AppLoader将在应用UI最上层展示一个灰色的“球”：
4、点击该“球”，AppLoader将会在屏幕上弹出一个配置调试服务信息的对话框：
5、将2中在Studio中查看到的IP地址及端口号依次填入配置框中：
6、点击对话框中的“连接”按钮，如果配置正确，将显示连接成功，同时“球”变为绿色。（如果连接不成功，可关闭电脑防火墙后重试。）：
7、连接成功后，即可在Studio中通过在项目上右键，或者快捷键的方式对某项目进行WiFi真机同步：
8、同步状态将实时显示在真机屏幕上，同步完成后AppLoader将自动热重启该应用：
9、连接成功后，也可在Studio项目的任意html文件上右键，或者快捷键的方式对该文件进行WiFi真机实时预览：
自定义WiFi同步时忽略的文件、文件夹
支持在项目根目录添加 .syncignore 文件,来自定义想在在真机同步时忽略的文件.这一功能,对于那些基于webpack等自动化工具构建项目的开发者来说,意义重大.
不同于svn/git等的ignore,APICloud Studio 2.0 真机同步的 ignore 功能基于node-glob开发,支持标准的Glob表达式.
常用格式示例
- 忽略某一类型的文件,如 *.js.map 文件:
**/*.js.map
- 忽略项目中所有某一名称的文件夹极其子文件(夹),如node_modules目录:
**/node_modules/**
- 忽略根目录中某一目录下的所有文件(夹),如src目录:
src/**
- 基于自动化webpack等自动化构建工具常用的表达式:
{**/*.js.map,**/node_modules/**,src/**}
其他说明
- 1、快捷键：WiFi真机同步快捷键为[Control + I]，WiFi真机预览快捷键为[Control + O]
- 2、自定义loader和AppLoader默认开启WiFi真机同步和实时预览功能，云编译APP会自动关闭该功能
- 3、WiFi真机同步需保证手机和Studio在同一个局域网及同一个网段内。WiFi真机同步服务正常时，“球”显示为绿色，未连接则显示为灰色
- 4、只有当自定义loader或者AppLoader位于前台时，才可进行WiFi同步，应用退到后台，WiFi同步服务将自动关闭，直到回到前台时，再次自动开启。
- 5、WiFi真机同步与USB真机同步互不冲突，可同时使用
- 6、自定义loader只支持对该loader所在项目进行WiFi真机同步或实时预览，AppLoader支持对所连接的Studio中所有项目进行WiFi真机同步或实时预览
