【免费下载链接】DocumentServer项目地址https://gitcode.com/gh_mirrors/doc/DocumentServer点击查看免费下载Euro-Office DocumentServer 是一款开源的在线办公文档协作服务端支持文档、表格、演示文稿的网页编辑。在开发调试时桌面浏览器通过localhost就能打开编辑器但Android 模拟器和局域网里的手机却无法访问它——这正是make mobile要解决的问题。本指南带你用一条命令完成跨设备文档编辑测试自动探测宿主机局域网 IP、配置可访问的编辑地址并附 Playwright 移动端自动化冒烟测试的玩法。为什么 localhost 不够用跨设备测试的核心痛点make local等价于直接make启动的栈只在http://localhost:8081/上可用桌面浏览器和 iOS 模拟器够用但两类常见客户端会失联Android 模拟器它运行在独立虚拟网络里localhost指向模拟器自己必须用http://10.0.2.2这个特殊地址才能访问宿主机局域网真机手机/平板必须使用宿主机的局域网 IP而 Nextcloud 侧的DocumentServerUrl和trusted_domains也要同步指向这个 IP编辑器才能被手机端真正打开。手动改这些配置繁琐且容易漏项make mobile就是把这套流程自动化了。make mobile 三步快速上手前置条件已安装 Docker并已完成仓库克隆与构建用户配置参考 develop/README.md 开头的 Build Requisites 说明。以下命令均在develop/目录中执行。第 1 步拉取预构建开发镜像并启动make pull多架构amd64 arm64的:latest-dev镜像已预装好文档服务与 Nextcloud 连接器无需本地完整构建。第 2 步以 mobile 模式启动核心命令make mobile它会做三件事对应 develop/Makefile 中的mobile目标自动探测宿主机局域网 IPmacOS 用ipconfigLinux 用ip route见 develop/Makefile设置DocumentServerUrl http://你的IP:8080/并把该 IP 加入 Nextcloud 的trusted_domains见refresh-urls目标develop/Makefile在启动横幅中打印出完整的 Nextcloud 访问 URL方便直接抄到手机浏览器里。第 3 步在各设备打开对应地址客户端启动目标访问地址桌面浏览器make local/make mobilehttp://localhost:8081/iOS 模拟器make local/make mobilehttp://localhost:8081/Android 模拟器make mobile/make next-mobilehttp://10.0.2.2:8081/局域网真机make mobile/make next-mobilehttp://宿主机IP:8081/打开 Files 应用新建一个 docx 文档点开即可在手机或模拟器上验证文档、表格、演示文稿的移动端编辑效果 。两个实用技巧IP 变了和探测失败怎么办技巧 1局域网 IP 变化换 WiFi、开热点等不用重新构建直接刷新 URL 即可make refresh-urls该操作是幂等的会把DocumentServerUrl与trusted_domains重新对齐到当前模式develop/README.md 的 Testing from mobile devices and emulators 一节。在local与mobile模式之间来回切换也完全支持每次运行都会重新应用正确的地址。技巧 2自动探测失败时手动指定 IP在 Windows 原生环境或任何探测失败的场景直接传参覆盖make mobile HOST_LAN_IP192.168.1.50进阶用 make next-mobile 测试未发布的 Nextcloud 分支如果你在验证 Nextcloud 的未发布版本master、stable33、stable34桌面用make next手机端则改用make next-mobile它等价于next 自动注入局域网 IPmake next-mobile # mobile NC master 开发主干 make next-mobile NC_BRANCHstable34 # mobile NC34 稳定分支每个分支拥有独立的数据卷切换分支不会互相污染develop/Makefile。自动化验证Playwright 移动端冒烟测试真机测试之外项目内置了 Playwright 端到端测试无需手机即可验证移动端构建是否正常渲染。核心用例在 e2e/tests/mobile-editor.spec.ts通过 URL 参数?typemobile强制加载移动端 bundle绕过 UA 嗅探覆盖 Documentdocx、Spreadsheetxlsx、Presentationpptx三种编辑器模拟 414×896 的手机视口断言加载骨架屏消失 → 无错误弹窗 → 编辑画布可见 → 全程无 JS 异常专门拦截部署成功但运行时报错这类隐蔽问题运行入口在 e2e/package.json测试基础设施配置见 e2e/playwright.config.ts失败自动截图、首次重试录制 trace 与视频。global-setup.ts 还会自动拉起一个 Docker 文档服务容器并轮询健康检查跑之前什么都不用准备cd e2e npm install npm test常见问题 FAQQ1make mobile和make local有什么区别local跑在localhost只服务桌面浏览器与 iOS 模拟器mobile额外注入局域网 IP让 Android 模拟器与局域网真机也能打开编辑器。两者可在同一栈上随时切换。Q2横幅里的 Nextcloud URL 打不开先确认手机与宿主机在同一局域网再检查宿主机防火墙是否放行了 8081 端口。IP 变化时执行make refresh-urls。Q3启动时提示 Nextcloud 数据版本落后说明本地镜像落后于数据卷按提示执行docker pull nextcloud:latest后重新make即可检测逻辑见 develop/Makefile。Q4想完全重置 Nextcloud 数据make wipe-nc # 清除 nc_data_latest make wipe-nc NC_VERSION33 # 清除指定版本的数据卷小结场景命令桌面浏览器日常开发make localAndroid 模拟器 / 局域网真机make mobile测试未发布 Nextcloud 分支手机端make next-mobile NC_BRANCHstable34局域网 IP 变化后热更新make refresh-urls无真机时的移动端自动化冒烟cd e2e npm test掌握make mobile后你的文档协作服务就能在开发机上一次启动、多端访问跨设备文档编辑测试从此只需一条命令 ✅。赞分享【免费下载链接】DocumentServer项目地址https://gitcode.com/gh_mirrors/doc/DocumentServer点击查看免费下载相关推荐3个关键优化让Windows性能飙升AtlasOS完整配置指南3个关键优化让Windows性能飙升AtlasOS完整配置指南 你是否厌倦了Windows系统臃肿缓慢的体验想要一个更流畅、更私密、更高效的操作系统Atl操作系统隐私合规精通Euro-Office DocumentServer组件级增量构建web-apps、sdkjs、core与server的make目标实战精通Euro Office DocumentServer组件级增量构建web apps、sdkjs、core与server的make目标实战 DocumentOpenResume设备测试策略模拟器与真实设备结合OpenResume设备测试策略模拟器与真实设备结合 你是否曾遇到过这样的尴尬精心制作的简历在电脑上看起来完美无瑕发送给招聘方后却发现格式错乱、字体显示异前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考