APICloud Studio WiFi真机同步和WiFi真机预览使用说明

概述

WiFi真机同步,通过在Studio中建立调试服务,接收真机设备主动连接调试的方式,配合apploader及自定义loader,为开发者提供在局域网内通过WiFi实现应用快速真机同步和实时预览的服务,摆脱应用开发调试过程中,真机同步时必须依赖USB数据线的困扰,完美解决了USB数据线真机同步方式存在的各种问题,具有更强的稳定性和兼容性。WiFi真机同步支持一对多的同步,即同一个项目可同时同步到多个真机;WiFi真机的同步策略为“增量”策略,即每次同步仅同步被编辑过的文件,因此同步速度非常快,几乎可以达到“秒同”;

WiFi真机实时预览,提供在真机上实时加载运行指定页面并预览效果的功能,支持对包括模块在内的所有端API的调试和预览。

WiFi真机同步、WiFi真机实时预览视频教程

使用流程

使用前,要使电脑和手机连接的是同一个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真机同步或实时预览