Share via


Elemento Resources

Contém ícones, cadeias de caracteres e URLs para o nó VersionOverrides. Um elemento de manifesto especifica um recurso usando a d do recurso. Isso ajuda a manter o tamanho do manifesto manejável, especialmente quando os recursos tiverem versões para localidades diferentes. Uma id deve ser exclusiva dentro do manifesto e pode ter no máximo 32 caracteres.

Tipo de suplemento: Painel de tarefas, Email

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto.

Cada recurso pode ter um ou mais <elementos filho de substituição> para definir um recurso diferente para uma localidade específica.

Elementos filho

Elemento Tipo Descrição
Imagens image Fornece a URL HTTPS de uma imagem para um ícone.
<URLs> url Fornece um local para a URL HTTPS. A URL pode ter 2.048 caracteres no máximo.
<ShortStrings> string O texto para <elementos Rótulo> e <Título> . Cada <Cadeia de Caracteres> contém um máximo de 125 caracteres.
<LongStrings> string O texto para <atributos Descrição> . Cada <Cadeia de Caracteres> contém um máximo de 250 caracteres.

Observação

Você deve usar a SSL (Secure Sockets Layer) para todas as URLs nos <elementos Imagem> e <Url> .

Imagens

Cada ícone deve ter três <elementos Imagens> , um para cada um dos três tamanhos obrigatórios:

  • 16 x 16
  • 32x32
  • 80x80

Os seguintes tamanhos adicionais também têm suporte, mas não são necessários.

  • 20x20
  • 24x24
  • 40x40
  • 48x48
  • 64x64

Há suporte para os seguintes formatos de arquivo de imagem.

  • Bmp
  • EXIF
  • GIF
  • Jpg
  • PNG
  • TIFF

Importante

  • Se essa imagem for o ícone representativo do suplemento, consulte Criar listagens efetivas no AppSource e no Office para obter tamanho e outros requisitos.
  • Os suplementos do Office exigem a capacidade de armazenar em cache recursos de imagem para fins de desempenho. Por esse motivo, o servidor que hospeda um recurso de imagem não deve adicionar nenhuma diretriz CACHE-CONTROL ao cabeçalho da resposta. Essas diretivas resultam em Office substituindo automaticamente uma imagem genérica ou padrão. Para forçar o uso de novos ícones no computador de desenvolvimento, desmarque o cache do Office. Para forçar o uso de novos ícones nos computadores do usuário final, você deve fornecer aos novos ícones uma URL diferente dos antigos.

Exemplos de recursos

<Resources>
      <bt:Images>
        <bt:Image id="icon1_16x16" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp16-icon_default.png" />
        </bt:Image>
        <bt:Image id="icon1_32x32" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp32-icon_default.png" />
        </bt:Image>
        <bt:Image id="icon1_80x80" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp80-icon_default.png" />
        </bt:Image>
      </bt:Images>
      <bt:Urls>
        <bt:Url id="residDesktopFuncUrl" DefaultValue="https://www.contoso.com/Pages/Home.aspx">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/Pages/Home.aspx" />
        </bt:Url>
      </bt:Urls>
      <bt:ShortStrings>
        <bt:String id="residLabel" DefaultValue="GetData">
          <bt:Override Locale="ja-jp" Value="JA-JP-GetData" />
        </bt:String>
      </bt:ShortStrings>
      <bt:LongStrings>
        <bt:String id="residToolTip" DefaultValue="Get data for your document.">
          <bt:Override Locale="ja-jp" Value="JA-JP - Get data for your document." />
        </bt:String>
      </bt:LongStrings>
    </Resources>
<Resources>
  <bt:Images>
    <!-- Blue icon -->
    <bt:Image id="blue-icon-16" DefaultValue="YOUR_WEB_SERVER/blue-16.png"/>
    <bt:Image id="blue-icon-32" DefaultValue="YOUR_WEB_SERVER//blue-32.png"/>
    <bt:Image id="blue-icon-80" DefaultValue="YOUR_WEB_SERVER/blue-80.png"/>
  </bt:Images>
  <bt:Urls>
    <bt:Url id="functionFile" DefaultValue="YOUR_WEB_SERVER/FunctionFile/Functions.html"/>
    <!-- other URLs -->
  </bt:Urls>
  <bt:ShortStrings>
    <bt:String id="groupLabel" DefaultValue="Add-in Demo">
      <bt:Override Locale="ar-sa" Value="<Localized text>" />
    </bt:String>
    <!-- Other short strings -->
  </bt:ShortStrings>
  <bt:LongStrings>
    <bt:String id="funcReadSuperTipDescription" DefaultValue="Gets the subject of the message or appointment.">
      <bt:Override Locale="ar-sa" Value="<Localized text>." />
    </bt:String>
    <!-- Other long strings -->
  </bt:LongStrings>
</Resources>