离线部署中经常遇到的问题汇总

回复

1. ThingJS在线开发中如何下载离线部署包？

答：在线开发下载离线部署包操作步骤：
1. 需要打开自己需要离线部署的项目，选择【项目】->【部署项目】->【离线部署】

离线部署中经常遇到的问题汇总

2. 选择【重新申请打包下载】

离线部署中经常遇到的问题汇总

3. 打包完成后，点击【下载】按钮，就可以获取到项目离线部署包了

离线部署中经常遇到的问题汇总

      4. 然后按照离线部署文档（http://3dmomoda-static.oss-cn-be ... %B4%E6%98%8E3.0.pdf）进行后续操作即可

2. ThingJS在线开发中下载离线部署包提示”场景xxxxxx无权限下载“是怎么回事呢？

答：当下载项目离线部署包时出现”场景xxxxxx无权限下载“时，一般是因为使用了非自有账号的场景导致的无法下载，需要检查项目中添加的场景（包括动态创建的场景、CityBuilder中摆放的场景等等）是否为自己账号下的。

3. ThingJS在线开发中下载离线部署包时提示”仅支持一个场景“是什么原因呢？

答：VIP账号享受离线部署包试用，但是试用版本的仅支持下载单场景项目的离线部署包，如果项目中需要使用多场景进行项目离线部署打包，需要购买正式离线部署获取正式离线部署码进行正式离线部署操作。

4. ThingJS在线开发中下载离线部署包的时候，打包提示”read file error“，是什么原因呢？

答：ThingJS在线开发中下载离线部署包的时候，打包提示”read file error“，可以检查以下内容排查原因：
      1. 脚本中场景的引用地址写的是绝对路径，而非相对路径导致的，可以将脚本中场景的地址” https://www.thingjs.....“格式更改成 ”/api/scene/.....“的形式就可以；
      2. 检查主文件是否有报错；
      3. 主文件是否为空；
      4. cps文件是否配置错误，比如打开了官方注释（该场景链接仅用作示例），未引用自己正确的场景路径；
         离线部署中经常遇到的问题汇总

5. cps是否配置了不存在的thingJs版本号；

5. 项目进行离线部署打包时有几次机会呢？

答：VIP账号每个月都有四次离线部署打包机会，和正式离线部署打包机会共用，非VIP账号购买正式离线部署后共有四次打包机会。

离线部署中经常遇到的问题汇总

6. 每个月的离线部署打包机会或者授权机会用完了之后怎么办呢？

答：部分用户进行离线部署测试的频率比较高，所以当每个月四次的离线部署打包和授权机会用完之后，我们也提供了授权和打包次数的购买方式，付款完成后本月将增加1次授权或者4次打包机会。

离线部署中经常遇到的问题汇总

7. 在线开发的项目中引用了第三方资源，离线部署的时候可以一起打包下来吗？

答：在线开发中建议直接上传资源进行使用，离线部署的时候不会自动打包引用的第三方资源。

8. 在线开发正常运行项目，离线部署后访问 127.0.0.1:9000，3D场景展示出错是什么原因呢？

答：用于部署的网络服务器一般不强调显示，故显卡较差，甚至无独立显卡。而3D 场景显示对显卡要求较高，直接在服务器上 127.0.0.1 访问，服务器显卡不足以支持 3D 场景渲染展示，往往场景会显示出错。故可用有独立显卡的客户机浏览器访问该服务器场景，来验证 3D 场景显示是否正常。

9. 离线部署中场景、模型未离线下载，是什么原因呢？

答：一般情况，离线程序会自动打包项目所引用场景和模型，因为开发人员程序写法多样，离线程序很难一一识别，所以加了 cps 配置文件，辅助打包。如遇项目引用场景或模型未离线的情况，需在在线开发中自行配置项目对应的 cps 文件并重新打包。cps文件配置方法可以看一下里面的相关注释说明。

10. 离线部署后的脚本文件可以修改吗，修改后需要重新打包授权吗？

答：离线修改脚本文件，不用重新打包和重新激活。项目的脚本文件为 web 目录下对应项目名称的 js 文件，例如 web\index.js。修改完脚本文件后重新访问服务器立即生效。脚本文件可以用任意文本编辑器编辑。修改脚本文件无需重新打包和重新激活。

11. 离线部署的项目场景进行了修改，需要重新进行打包授权吗？

答：通过 CampusBuilder 修改 3D 场景后，同步或导出 tjs 包上传至 ThingJS 官网，重新打包下载并授权激活。通过在线CityBuilder 编辑的 3D 城市场景也可在修改后，通过重新打包下载并授权激活。自定义模型可通过 CampusBuilder 上传，并同场景一同导出。

12. 离线部署的端口号可以修改吗？

答：离线部署的服务器默认端口号为9000 。可以修改system\conf目录下的application.properties来修改端口号。注意不要和原来的服务端口或者本地端口号冲突，如果端口冲突会无法启动 start.exe。参见下图：

离线部署中经常遇到的问题汇总

13. 在线开发中使用了”// 动态引入ECharts.js THING.Utils.dynamicLoad(['/guide/lib/echarts.min.js'], function () {});“，但是离线部署项目运行后找不到这个文件应该怎么处理？

答：可以直接线上访问下载这个文件，下载之后打开离线部署包 /web/lib 目录下，然后修改项目js文件中的引用地址为相对地址（“./lib/echart.min.js”）。

14. 离线部署后，添加的ChartBuilder 图表模板没有显示是什么原因呢？

答：离线部署的项目如果有添加图表内容的话，需要在项目授权服务启动完成后，访问：127.0.0.1:9000/chart就可以看到整体项目了。

15.chartbuilder项目，离线部署后显示如下图是为什么呢？
离线部署中经常遇到的问题汇总

答：chartbuilder项目离线部署后，默认配置的是本地9000端口，如使用ip+自定义端口的方式访问，需要自行修改scene.def文件中的iframeURL。如下图所示：

离线部署中经常遇到的问题汇总

16. V3.0版本的离线部署项目部署后加载为什么3d项目不显示？

答：离线部署的项目按照文档部署后，如果不显示3d内容，可能是因为下载的离线部署不是最新版本的原因导致的，可以在在线开发中打开需要离线部署的项目，点击工具-设置，然后再弹出来的面板中选择 thingjs和uearth库全部更新为最新版进行保存，然后重新申请离线部署包下载就可以的，设置版本操作见下图：

离线部署中经常遇到的问题汇总

17.项目进行离线部署后，未离线地球相关内容是什么原因呢？

答：项目进行离线部署打包前请检查主文件js中，是否有使用扩展运算符(…)，这个符号将影响打包程序运行失败，如有使用，需要在申请打包前先注释掉相关代码，打包结束后可复原。

18. 项目进行离线部署的时候，如果提示激活失败或有中文乱码的情况是什么原因呢？

答：项目进行离线部署的时候，如果提示激活失败或有中文乱码的情况，请确认部署环境的编码是否为zh_CN.UTF-8

19. 离线部署后访问，加载场景报错，浏览器控制台打印“127.0.0.1:9000/api/scene/xxxxxxx/index.json” 404 等是什么原因导致的呢？

答：当离线部署后访问页面，加载场景出现报错，浏览器控制台打印“127.0.0.1:9000/api/scene/xxxxxxx/index.json” 404 的时候，我们可以通过以下两方面进行具体检查：

1. 先查看离线部署包中是否有/web/scene目录，如有，则说明场景已打包，如没有，请配置cps文件；
2. 如场景已离线，仍报错，请检查脚本中引用场景的地方，需将URL由”/api/scene/xxxxxxx“更改为离线访问地址”./scene/1“；

20. 森城市离线部署后如何更换瓦片服务配置？

答：更换森城市离线部署后瓦片服务配置操作步骤：
1. 打开 /web/cityBuilder 中对应地图场景目录下的 source.cfg 文件，找到配置瓦片图层的地方：
离线部署中经常遇到的问题汇总