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

概述

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

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

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

使用流程

使用前,要使电脑和手机连接的是同一个WiFi。

  • 1、点击Studio菜单栏的“帮助”按钮,在弹出的下拉菜单中点击“查看WiFi真机同步服务器地址”: 图片说明

  • 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同步时忽略的文件、文件夹

在项目根目录下增加.ignore.txt 文件。 支持忽略指定文件夹,指定文件。 如.ignore.txt中的内容为:

image   // 文件夹名

res     // 文件夹名

1.png   // 文件名

其他说明

  • 1、快捷键:WiFi真机同步快捷键为[Control + I],WiFi真机预览快捷键为[Control + E]
  • 2、自定义loader和AppLoader默认开启WiFi真机同步和实时预览功能,云编译APP会自动关闭该功能
  • 3、WiFi真机同步需保证手机和Studio在同一个局域网及同一个网段内。WiFi真机同步服务正常时,“球”显示为绿色,未连接则显示为灰色
  • 4、只有当自定义loader或者AppLoader位于前台时,才可进行WiFi同步,应用退到后台,WiFi同步服务将自动关闭,直到回到前台时,再次自动开启。
  • 5、WiFi真机同步与USB真机同步互不冲突,可同时使用
  • 6、自定义loader只支持对该loader所在项目进行WiFi真机同步或实时预览,AppLoader支持对所连接的Studio中所有项目进行WiFi真机同步或实时预览