在移动设备上的 Outlook 中添加对外接程序命令的支持

1. 在“extensions.ribbons.requirements.formFactors”数组中，添加“mobile”作为项。 完成后，数组应如下所示。

   "formFactors": [
       "mobile",
       <!-- Typically there will be other form factors listed. -->
   ]
   

2. 如果外接程序使用“约会与会者”模式，例如将笔记记录或客户关系管理的提供商集成 (CRM) 应用程序的外接程序，请将“logEventMeetingDetailsAttendee”添加到“extensions.ribbons.contexts”数组。 示例如下。

   "contexts": [
       "meetingDetailsAttendee",
       "logEventMeetingDetailsAttendee"
   ],
   

3. 如果外接程序使用集成的联机会议提供程序，请将“onlineMeetingDetailsOrganizer”添加到“extensions.ribbons.contexts”数组。 示例如下。

   "contexts": [
       "meetingDetailsOrganizer",
       "onlineMeetingDetailsOrganizer"
   ],
   

4. 在“extensions.ribbons.tabs”数组中，找到“builtInTabId”为“TabDefault”的选项卡。 将子“customMobileRibbonGroups”数组添加到其中， (作为现有“groups”属性) 的对等方。 在此数组中，创建一个 对象并执行以下操作：

   • 设置适当的“id”和“label”值。
   • 在“controls”数组中创建对象以表示按钮，并按如下所示对其进行配置。
     • 设置适当的“id”和“label”值。 为确保按钮正确适合功能区，建议将“标签”限制为 16 个字符。
     • 将“type”设置为“mobileButton”。
     • 将函数分配给“actionId”属性。 这应与“extensions.runtimes.actions”数组中对象的“id”匹配。
     • 请确保具有全部九个必需图标。

   示例如下。

   "tabs": [
       {
           "builtInTabId": "TabDefault",
           "groups": [
               <-- non-mobile group objects omitted -->
           ],
           "customMobileRibbonGroups": [
               {
                   "id": "mobileApptComposeGroup",
                   "label": "Contoso Meeting",
                   "controls": [
                       { 
                           "id": "mobileInsertMeetingButton",
                           "label": "Add meeting",
                           "type": "mobileButton",
                           "actionId": "insertContosoMeeting",
                           "icons": [
                               {
                                   "scale": 1,
                                   "size": 25,
                                   "url": "https://contoso.com/assets/icon-25.png"
                               },
                               {
                                   "scale": 1,
                                   "size": 32,
                                   "url": "https://contoso.com/assets/icon-32.png"
                               },
                               {
                                   "scale": 1,
                                   "size": 48,
                                   "url": "https://contoso.com/assets/icon-48.png"
                               },                                
                               {
                                   "scale": 2,
                                   "size": 25,
                                   "url": "https://contoso.com/assets/icon-25.png"
                               },
                               {
                                   "scale": 2,
                                   "size": 32,
                                   "url": "https://contoso.com/assets/icon-32.png"
                               },
                               {
                                   "scale": 2,
                                   "size": 48,
                                   "url": "https://contoso.com/assets/icon-48.png"
                               },                                
                               {
                                   "scale": 3,
                                   "size": 25,
                                   "url": "https://contoso.com/assets/icon-25.png"
                               },
                               {
                                   "scale": 3,
                                   "size": 32,
                                   "url": "https://contoso.com/assets/icon-32.png"
                               },
                               {
                                   "scale": 3,
                                   "size": 48,
                                   "url": "https://contoso.com/assets/icon-48.png"
                               }
                           ]
                       }
                   ]
               }
           ]
       }
   ]    
   

VersionOverrides v1.1 架构定义了移动 MobileFormFactor 的新外形规格。

此元素包含在移动客户端中加载外接程序所需的所有信息。 这使你可以为移动体验定义完全不同的 UI 元素和 JavaScript 文件。

以下示例演示 MobileFormFactor> 元素中的单个<任务窗格按钮。

<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
  ...
  <MobileFormFactor>
    <FunctionFile resid="residUILessFunctionFileUrl" />
    <ExtensionPoint xsi:type="MobileMessageReadCommandSurface">
      <Group id="mobileMsgRead">
        <Label resid="groupLabel" />
        <Control xsi:type="MobileButton" id="TaskPaneBtn">
          <Label resid="residTaskPaneButtonName" />
          <Icon xsi:type="bt:MobileIconList">
            <bt:Image size="25" scale="1" resid="tp0icon" />
            <bt:Image size="25" scale="2" resid="tp0icon" />
            <bt:Image size="25" scale="3" resid="tp0icon" />

            <bt:Image size="32" scale="1" resid="tp0icon" />
            <bt:Image size="32" scale="2" resid="tp0icon" />
            <bt:Image size="32" scale="3" resid="tp0icon" />

            <bt:Image size="48" scale="1" resid="tp0icon" />
            <bt:Image size="48" scale="2" resid="tp0icon" />
            <bt:Image size="48" scale="3" resid="tp0icon" />
          </Icon>
          <Action xsi:type="ShowTaskpane">
            <SourceLocation resid="residTaskpaneUrl" />
          </Action>
        </Control>
      </Group>
    </ExtensionPoint>
  </MobileFormFactor>
  ...
</VersionOverrides>

这与 DesktopFormFactor 元素中出现的元素非常相似，但具有一些明显的区别。

• 不使用 OfficeTab 元素。
• ExtensionPoint 元素必须仅具有一个子元素。 如果外接程序实现 MobileOnlineMeetingCommandSurface 或 MobileLogEventAppointmentAttendee 扩展点，则必须包含 Control 子元素。 如果外接程序实现 MobileMessageReadCommandSurface 扩展点，则必须包含包含多个 <Control> 元素的 Group 子元素。
• Control 元素没有Menu等效<的类型。>
• 不使用 Supertip 元素。
• 要求的图标大小不同。 移动外接程序最少必须支持 25x25、32x32 和 48x48 像素的图标。 有关详细信息，请参阅 移动外形规格的其他要求。