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

概述

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

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

WiFi日志调试： 支持WiFi调试模式下日志输出。 启动日志快捷键[ctrl]+[alt]+[w]。 请在官网下载最新插件后使用此功能。插件包中APICloudWiFiDebugView和APICloudWiFiSync文件夹下的内容有更新。 替换插件后，需重启Sublime和WiFi真机同步服务。

下载插件

在APICloud官网开发工具页面(//www.apicloud.com/devtools) 下载Sublime插件包。解压到Sublime 的Packages 目录下。如图：

安装使用

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

• 1、在Sublime中的APICloud项目上右键，出现菜单，（Mac版无需安装服务，直接启动服务即可）。如图：

• 2、点击【安装服务】，弹出是否允许安装，选择是。安装一次即可，再次打开Sublime不需要再次安装。 如果有360相关软件弹出的拦截窗口，请选择允许安装，否则会导致安装失败。（Mac版无需安装服务，直接启动服务即可。）开始安装WiFi同步服务。安装完成会有弹出框提示“完成安装APICloud真机同步服务”。

• 3、点击【启动服务】，开启WiFi同步服务。开启完成后，自动弹出端口号和ip。注意如果弹出的端口号是0，请点击【查看WiFi真机同步服务器地址】，查看Sublime在本地建立的调试服务地址及端口。

• 4、打开您手机上的AppLoader或自定义loader（如果手机上还未安装最新版AppLoader，请先安装最新版AppLoader，），最新版AppLoader将在应用UI最上层展示一个灰色的“球”。

• 5、点击该“球”，AppLoader将会在屏幕上弹出一个配置调试服务信息的对话框：

• 6、将在Sublime中查看到的IP地址及端口号依次填入配置框中：

• 7、点击对话框中的“连接”按钮，如果配置正确，将显示连接成功，同时“球”变为绿色。（如果连接不成功，可关闭电脑防火墙后重试。）：

• 8、连接成功后，即可在Sublime中通过在项目上右键，选择“WiFi真机同步”或者快捷键的方式对某项目进行WiFi真机同步：

• 9、同步状态将实时显示在真机屏幕上，同步完成后AppLoader将自动热重启该应用：

• 10、连接成功后，也可在Sublime项目的任意html文件上右键，或者快捷键的方式对该文件进行WiFi真机实时预览：

• 11、 自定义WiFi同步时忽略的文件、文件夹

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

image   // 文件夹名
res     // 文件夹名
1.png   // 文件名

其他说明

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