Office插件将不会在Excel的本地桌面版本中显示-清单问题?

时间:2018-07-12 11:47:51

标签: xml excel vue.js office-js

我是Microsoft Office Addin开发的新手,我已经用JavaScript和Vue.js完成了我的第一个Excel Addin(yeh)。

它完全可以在联机Office 365 Excel变体内运行。由于我不是经过验证的Developer或365 Admin,因此我每次都会将manifest.xml上传到Office.com。

我现在正在按照以下指南尝试使我的Addin在本地版本中运行:https://docs.microsoft.com/en-us/office/dev/add-ins/testing/create-a-network-shared-folder-catalog-for-task-pane-and-content-add-ins

结果:对话框中未显示单个插件(..“共享插件” ...)

我试图通过对清单进行验证来解决该问题-看起来像这样:

<?xml version="1.0" encoding="UTF-8"?>
<OfficeApp
          xmlns="http://schemas.microsoft.com/office/appforoffice/1.1"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0"
          xmlns:ov="http://schemas.microsoft.com/office/taskpaneappversionoverrides"
          xsi:type="TaskPaneApp">

  <!-- Begin Basic Settings: Add-in metadata, used for all versions of Office unless override provided. -->

  <!-- IMPORTANT! Id must be unique for your add-in, if you reuse this manifest ensure that you change this id to a new GUID. -->
  <Id>8changed-249c-4bdf-8b4a-changed407f5</Id>

  <!--Version. Updates from the store only get triggered if there is a version change. -->
  <Version>1.0.0.0</Version>
  <ProviderName>[Provider name]</ProviderName>
  <DefaultLocale>en-US</DefaultLocale>
  <!-- The display name of your add-in. Used on the store and various places of the Office UI such as the add-ins dialog. -->
  <DisplayName DefaultValue="myAddin" />
  <Description DefaultValue="[Workbook Add-in description]"/>

  <!-- Icon for your add-in. Used on installation screens and the add-ins dialog. -->
  <IconUrl DefaultValue="https://myAddin..mydomain.xxx/assets/icon-32.png" />
  <HighResolutionIconUrl DefaultValue="https://myAddin..mydomain.xxx/assets/hi-res-icon.png"/>

  <!--If you plan to submit this add-in to the Office Store, uncomment the SupportUrl element below-->
  <!--<SupportUrl DefaultValue="[Insert the URL of a page that provides support information for the app]">-->

  <!--Begin TaskPane Mode integration. This section is used if there are no VersionOverrides or if the Office client version does not support add-in commands. -->
  <Hosts>
    <Host Name="Workbook" />
  </Hosts>
  <DefaultSettings>
    <SourceLocation DefaultValue="https://myAddin..mydomain.xxx/index.html" />
  </DefaultSettings>
  <!-- End TaskPane Mode integration.  -->

  <Permissions>ReadWriteDocument</Permissions>

  <!-- Domains that will be allowed when navigating. For example, if you use ShowTaskpane and then have an href link, navigation will only be allowed if the domain is on this list. -->
  <AppDomains>
    <AppDomain>some.text.io</AppDomain>
    <AppDomain>myAddin..mydomain.xxx</AppDomain>
  </AppDomains>
  <!--End Basic Settings. -->


  <!-- Begin Add-in Commands Mode integration. -->
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">

    <!-- The Hosts node is required. -->
    <Hosts>
      <!-- Each host can have a different set of commands. -->
      <!-- Excel host is Workbook, Word host is Document, and PowerPoint host is Presentation. -->
      <!-- Make sure the hosts you override match the hosts declared in the top section of the manifest. -->
      <Host xsi:type="Workbook">
        <!-- Form factor. Currently only DesktopFormFactor is supported. -->
        <DesktopFormFactor>
          <!--"This code enables a customizable message to be displayed when the add-in is loaded successfully upon individual install."-->
          <GetStarted>
            <!-- Title of the Getting Started callout. resid points to a ShortString resource -->
            <Title resid="Contoso.GetStarted.Title"/>

            <!-- Description of the Getting Started callout. resid points to a LongString resource -->
            <Description resid="Contoso.GetStarted.Description"/>

            <!-- Point to a url resource which details how the add-in should be used. -->
            <LearnMoreUrl resid="Contoso.GetStarted.LearnMoreUrl"/>
          </GetStarted>
          <!-- Function file is a HTML page that includes the JavaScript where functions for ExecuteAction will be called.
            Think of the FunctionFile as the code behind ExecuteFunction. -->
          <!--<FunctionFile resid="Contoso.DesktopFunctionFile.Url" />-->

          <!-- PrimaryCommandSurface is the main Office Ribbon. -->
          <ExtensionPoint xsi:type="PrimaryCommandSurface">
            <!-- Use OfficeTab to extend an existing Tab. Use CustomTab to create a new tab. -->
            <OfficeTab id="TabHome">
              <!-- Ensure you provide a unique id for the group. Recommendation for any IDs is to namespace using your company name. -->
              <Group id="Contoso.Group1">
                <!-- Label for your group. resid must point to a ShortString resource. -->
                <Label resid="Contoso.Group1Label" />
                <!-- Icons. Required sizes 16,32,80, optional 20, 24, 40, 48, 64. Strongly recommended to provide all sizes for great UX. -->
                <!-- Use PNG icons. All URLs on the resources section must use HTTPS. -->
                <Icon>
                  <bt:Image size="16" resid="Contoso.tpicon_16x16" />
                  <bt:Image size="32" resid="Contoso.tpicon_32x32" />
                  <bt:Image size="80" resid="Contoso.tpicon_80x80" />
                </Icon>

                <!-- Control. It can be of type "Button" or "Menu". -->
                <Control xsi:type="Button" id="Contoso.TaskpaneButton">
                  <Label resid="Contoso.TaskpaneButton.Label" />
                  <Supertip>
                    <!-- ToolTip title. resid must point to a ShortString resource. -->
                    <Title resid="Contoso.TaskpaneButton.Label" />
                    <!-- ToolTip description. resid must point to a LongString resource. -->
                    <Description resid="Contoso.TaskpaneButton.Tooltip" />
                  </Supertip>
                  <Icon>
                    <bt:Image size="16" resid="Contoso.tpicon_16x16" />
                    <bt:Image size="32" resid="Contoso.tpicon_32x32" />
                    <bt:Image size="80" resid="Contoso.tpicon_80x80" />
                  </Icon>

                  <!-- This is what happens when the command is triggered (E.g. click on the Ribbon). Supported actions are ExecuteFunction or ShowTaskpane. -->
                  <Action xsi:type="ShowTaskpane">
                    <TaskpaneId>ButtonId1</TaskpaneId>
                    <!-- Provide a url resource id for the location that will be displayed on the task pane. -->
                    <SourceLocation resid="Contoso.Taskpane.Url" />
                  </Action>
                </Control>
              </Group>
            </OfficeTab>
          </ExtensionPoint>
        </DesktopFormFactor>
      </Host>
    </Hosts>

    <!-- You can use resources across hosts and form factors. -->
    <Resources>
      <bt:Images>
        <bt:Image id="Contoso.tpicon_16x16" DefaultValue="https://myAddin..mydomain.xxx/assets/img/textengine-logo-flat.svg" />
        <bt:Image id="Contoso.tpicon_32x32" DefaultValue="https://myAddin..mydomain.xxx/assets/img/textengine-logo-flat.svg" />
        <bt:Image id="Contoso.tpicon_80x80" DefaultValue="https://myAddin..mydomain.xxx/assets/img/textengine-logo-flat.svg" />
      </bt:Images>
      <bt:Urls>
        <bt:Url id="Contoso.Taskpane.Url" DefaultValue="https://myAddin..mydomain.xxx/index.html" />
        <bt:Url id="Contoso.GetStarted.LearnMoreUrl" DefaultValue="https://go.microsoft.com/fwlink/?LinkId=276812" />
        <bt:Url id="Contoso.DesktopFunctionFile.Url" DefaultValue="https://myAddin..mydomain.xxx/index.html" />
      </bt:Urls>
      <!-- ShortStrings max characters==125. -->
      <bt:ShortStrings>
        <bt:String id="Contoso.TaskpaneButton.Label" DefaultValue="myAddin" />
        <bt:String id="Contoso.Group1Label" DefaultValue="myAddin" />
        <bt:String id="Contoso.GetStarted.Title" DefaultValue="Get some Content generated!" />
      </bt:ShortStrings>
      <!-- LongStrings max characters==250. -->
      <bt:LongStrings>
        <bt:String id="Contoso.TaskpaneButton.Tooltip" DefaultValue="Click me to get some Content generated!" />
        <bt:String id="Contoso.GetStarted.Description" DefaultValue="myAddin loaded and ready to fire some Texts!" />
      </bt:LongStrings>
    </Resources>
  </VersionOverrides>
  <!-- End Add-in Commands Mode integration. -->

</OfficeApp>

验证给我以下错误:

    + validate-office-addin ./*manifest.xml
Calling validation service. This might take a moment...
-------------------------------------
Validation: Failed
Error #1: 
XML Schema Violation: Your manifest does not adhere to the current set of XML schema definitions for Office Add-in manifests. (link: https://aka.ms/add-in-manifest-schema-violation)
  - Details: The element 'OfficeApp' in namespace 'http://schemas.microsoft.com/office/appforoffice/1.1' has invalid child element 'AppDomains' in namespace 'http://schemas.microsoft.com/office/appforoffice/1.1'. List of possible elements expected: 'Dictionary' in namespace 'http://schemas.microsoft.com/office/appforoffice/1.1' as well as 'VersionOverrides' in namespace 'http://schemas.microsoft.com/office/taskpaneappversionoverrides' as well as any element in namespace 'http://www.w3.org/2000/09/xmldsig#'.
  - Line: 41
- Column: 4

遵循链接的指南https://aka.ms/add-in-manifest-schema-violation似乎没有犯任何错误。

有人可能比我更了解它,或者有一些调试技巧?

2 个答案:

答案 0 :(得分:1)

元素的顺序很重要。 (并且Microsoft尚未正确记录所需的顺序。)我相信 AppDomains 必须位于您的 HighResolutionIconUrl 元素和下面的 Hosts 元素之间它。清单的XSD(几乎)是人类可读的,可能会有所帮助:https://github.com/OfficeDev/office-js-docs-pr/tree/master/docs/overview/schemas/taskpane

答案 1 :(得分:0)

从根本上说,对我的问题“为什么它没有显示在Microsoft Office Excel的脱机版本中-甚至没有在'添加加载项页面'中也没有显示”的答案是: “脱机Excel”似乎不喜欢.svg(甚至没有在XML中指定)-我必须在文档中已经读了它。...我深入研究了git commits,并逐步将其逆转,直到发现为止。

这就是它

  <bt:Images>
    <bt:Image id="Contoso.tpicon_16x16" DefaultValue="https://myAddin..mydomain.xxx/assets/img/textengine-logo-flat.svg" />
    <bt:Image id="Contoso.tpicon_32x32" DefaultValue="https://myAddin..mydomain.xxx/assets/img/textengine-logo-flat.svg" />
    <bt:Image id="Contoso.tpicon_80x80" DefaultValue="https://myAddin..mydomain.xxx/assets/img/textengine-logo-flat.svg" />
  </bt:Images>

无论如何,谢谢Rick,很高兴知道这一点,并对我很有帮助,因为Validator Service仍然不认为我的清单是有效的。。(但这确实可行!:))