安装开发者工具-移动端

简介

使用 LightOS/JSN 技术开发的 App 是以 native 的方式运行在移动设备上,这使得传统的调试手段随之失效,有时候以浏览器模拟运行的方式并不能完整仿真 App 运行的环境,所以会出现一些在浏览器模拟运行时正常而真机设备运行异常的问题。

LightView 是 light 平台为开发调试移动端程序特别开发的一款工具,Lighting 开发套件结合 LightView 程序提供了针对 JSNative 程序的调试方法,使用此调试方法可以调试真实设备运行的状况,为应用开发的真机运行提供全流程的断点支持。

安装

Android

扫描下方二维码或点击这里下载安装包。

iOS

扫描下方二维码或在 AppStore 上搜索 lightview 进行下载安装。

环境检查

使用此调试方案之前需要检查当前的运行环境,最低的版本选项为:

  • lighting >=1.4.7-20171213
  • lighting-plugin-jsnative >= 1.0.7
  • lighting-plugin-debug >=1.0.2
  • 工程的project.json文件中配置启用jsnative插件

当发现当前的程序版本低于此运行环境时,请按照本章节升级环境。调试手机的网络和电脑设备的网络需在同一个网段。

开启服务

特别注意:新版本的 light release -wb 命令不再同时生成供调试的二维码。

  1. 安装debug插件:执行 light plugin -a debug 命令
  2. 运行项目:执行 light release -wb 命令,开启浏览器预览窗口(默认端口为3000)
  3. 开启调试窗口:执行 light server --debug 指令,自动开启浏览器调试窗口(默认端口为4000)

  1. 步骤2和3可以合并为一个命令:light release -wb --debug

开始调试

第一步:启动 LightView 扫描上图中调试页面的二维码即可建立与 Debugger Server 的通信,LightView 跳转到“运行调试”页面即表示手机调试连接成功。

第二步:回到 LightView 首页,扫描预览窗口中控制台的二维码,例如下图:

扫描成功后,调试窗口将会列出连接成功的设备信息:

第三步:在调试窗口的设备列表中,点击设备项的 Debugger 按钮,Chrome 将创建 Debugger 网页,根据页面中的提示按F12键打开控制台调试工具。

第四步:现在我们可以在手机上做一些操作,如果有 console 打印信息,你就会在上图所示的控制台看到你的打印信息,现在开始调试吧!

调试App程序

LightView 不仅可以在开发期对工程进行预览调试,也支持预览调试开发完成的 App。

第一步:使用 lighting 开发工具对 App 工程进行打包,将生成的 App 包提交到 light 平台,无需集成,选择对应的发布包并且点击预览,得到预览二维码。

第二步:使用 LightView 扫描此二维码,参见上文中“开始调试”步骤,只是在第二步中扫描的是已经传到平台的APP预览的二维码,就可以预览完整的APP程序,获得原生的完整的运行效果体验。

另外,如果在调试模式预览该二维码,还可以获得对此 App 调试的能力,方法参照上文中的调试步骤。

功能菜单

在使用 LightView 预览调试的过程中,可以拿起你的手机摇一摇召唤功能菜单,如果有任何的问题,点击反馈选项反馈遇到的问题,我们收到反馈后会在第一时间处理。