如何在iPad或其他移动设备上运行开发阶段的Office加载项?
解决方案
关于公网映射+自签名证书方案的可行性
这个方案完全可行,但需要注意几个关键细节:
- 公网映射:可以用
ngrok这类工具快速将本地https://localhost:3000映射成公网HTTPS地址,命令类似ngrok http https://localhost:3000 -host-header="localhost:3000" - 自签名证书配置:webpack需要生成并使用自签名证书,同时必须在iPad的iOS设置中手动信任该证书(路径:
设置 > 通用 > VPN与设备管理),否则会出现SSL证书验证失败,导致加载项无法加载 - manifest更新:将manifest.xml中所有指向
https://localhost:3000的地址替换为映射后的公网URL,重新侧加载即可
更简便的移动端调试方法
1. 微软官方iOS调试工具
使用Office Add-ins Debugger for iOS,它能直接建立PC与iPad的安全隧道,自动处理证书信任问题,无需手动配置公网映射:
- 在PC上启动加载项的webpack开发服务
- 在iPad上安装并打开该工具,输入PC的局域网IP和服务端口,即可连接并加载加载项,支持实时调试
2. 局域网HTTPS访问(无需公网)
如果PC和iPad在同一Wi-Fi局域网内:
- 修改webpack配置,将服务绑定到PC的局域网IP(比如
192.168.x.x),确保HTTPS启用并使用自签名证书 - 更新manifest.xml中的地址为
https://192.168.x.x:3000 - 在iPad上信任该自签名证书,重新侧加载即可访问
3. 离线打包加载(适合非实时调试场景)
- 执行
npm run build编译加载项,将dist目录打包成ZIP文件 - 在iPad的Word中侧加载这个ZIP包(替代manifest文件),即可离线运行加载项;代码修改后重新编译打包即可更新
内容的提问来源于stack exchange,提问作者Paul-Jan
相关产品推荐
相关产品推荐

