添加MobileFormFactor后Outlook Add-in安装失败求助

• MobileFormFactor配置细节踩坑
  虽然office-addin-manifest validate验证通过，但移动端配置有不少容易忽略的硬要求：

  • 确认<MobileFormFactor>下的<FunctionFile>必须指向完整HTTPS地址，不能用相对路径或者HTTP。比如清单里的配置要对应正确的资源URL：

    <MobileFormFactor>
      <FunctionFile resid="MobileFunctionFile" />
      <!-- 其他命令配置 -->
    </MobileFormFactor>
    

    对应的Resources节点里要写死HTTPS链接：

    <Resources>
      <bt:Urls>
        <bt:Url id="MobileFunctionFile" DefaultValue="https://your-domain.com/mobile-functions.html" />
      </bt:Urls>
    </Resources>
    

  • 检查移动端命令控件类型，Outlook移动端只支持<Button>，如果加了<Menu>这类不支持的控件，直接导致安装失败。

• 权限兼容性问题
  原插件的权限可能在移动端不兼容，比如原插件用了ReadWriteMailbox，但移动端某些场景只允许ReadItem权限，或者权限范围超出了移动端插件的允许范围，需要调整权限后再尝试安装。

• Office版本与平台限制

  • 确认安装插件的移动端Outlook是不是最新版，旧版本可能不支持MobileFormFactor配置，直接升级到最新版再试。
  • 检查插件是否针对正确的移动端平台配置，iOS和Android的配置虽然大部分通用，但个别细节可能有差异，比如图标尺寸要求不同，不符合的话也会报错。

• 清单隐性冲突
  工具验证不代表没有逻辑冲突：

  • 检查原插件的<FormSettings>和新增的<MobileFormFactor>有没有重复的Command ID，重复ID会触发安装失败。
  • 确认移动端配置的<ExtensionPoint>是否正确，Outlook移动端只认MessageReadCommandSurface和MessageComposeCommandSurface这两个扩展点，用其他类型直接报错。

• 网络与证书问题
  移动端对HTTPS证书要求比桌面端严，必须是受信任的CA颁发的证书，自签名证书在移动端会被拦截，导致安装失败。可以先在移动端浏览器里打开插件的FunctionFile地址，确认能正常访问且没有证书警告。

内容的提问来源于stack exchange，提问作者A. Ghergus