预览服务

Author: Charley

LayaAir IDE 内置 HTTP / HTTPS 预览服务器，用于项目的本地预览与调试。

通过预览服务，开发者可以精确控制预览服务的访问方式、安全策略以及多语言测试行为，以适配个人开发、团队协作和多项目并行等不同场景。

1. 主机地址（liveServerHost）

liveServerHost 用于指定预览服务器绑定的主机地址。

当该值为空字符串时，IDE 会自动获取当前设备的本地 IP 地址作为服务地址，这是最常见、也最省事的配置方式。

在实际开发中，是否显式指定该参数，通常取决于预览服务的访问范围。如果仅在本机浏览器中进行调试，将其设置为 localhost 即可，这样可以避免被局域网内的其他设备访问，安全性也更高。当需要在手机、平板或其他电脑上访问预览页面时，则应将其设置为当前设备在局域网中的 IP 地址。

在多网卡环境下（例如同时连接有线与无线网络），显式指定 liveServerHost 还能避免 IDE 自动选择到不可访问的网络接口，从而导致“服务已启动但无法访问”的问题。

类型与默认值

liveServerPort 用于指定预览服务的 HTTP 访问端口。IDE 会在启动预览服务时监听该端口，并通过该端口向浏览器提供项目资源。

默认端口为 18090，在大多数情况下无需修改。但当本机已有其他程序占用了该端口，或需要同时运行多个 LayaAir 项目进行对比测试时，就需要为不同项目配置不同的端口号，以避免冲突。

修改端口后，预览地址的访问形式为：

http://[host]:[liveServerPort]

如果预览服务启动失败并提示端口被占用，通常可以通过更换端口或关闭占用端口的程序来解决。

类型与默认值

liveServerSecurePort 用于配置 HTTPS 预览服务的访问端口。当项目涉及必须在 HTTPS 环境下才能使用的浏览器能力（如WebGPU、WebXR等）时，可以通过该端口进行测试。

与 HTTP 端口类似，该配置主要影响访问方式，而不会改变项目本身的逻辑行为。IDE 使用的是自签名证书，因此在浏览器中访问 HTTPS 预览地址时，出现安全警告属于正常现象，仅用于开发和测试阶段。

HTTPS 预览地址格式为：

https://[host]:[liveServerSecurePort]

类型与默认值

protectSourcemap 用于控制是否对 Source Map 文件进行访问保护。Source Map 描述了编译后代码与源代码之间的映射关系，在调试阶段可以显著提升问题定位效率，但同时也可能暴露源码结构。

在开发阶段，将该选项关闭可以直接通过浏览器开发者工具查看源码并进行断点调试；而在测试或对外预览环境中，通常建议保持默认开启状态，以防止 .map 文件被直接访问。

是否开启该选项，本质上是在“调试便利性”与“源码安全性”之间进行权衡。

类型与默认值

testLanguage 用于指定预览时使用的语言环境，主要面向多语言项目的测试需求。通过该配置，可以在不修改代码或资源配置的情况下，快速切换预览所使用的语言。

这一参数在验证多语言文本显示、布局适配以及语言资源完整性时尤为有用。例如，不同语言文本长度差异较大，可能会对 UI 布局产生影响，通过切换测试语言可以及早发现问题。

该值通常填写标准语言代码，如 zh-CN、en-US 等；未设置时，则使用项目默认语言。

类型与默认值