Compartilhar via

Notas de versão da Estrutura do SharePoint v1.4.1

  • Artigo

Lançamento:15 de fevereiro de 2018

Importante

Esta página aborda detalhes relacionados a uma versão SPFx específica. Esta página não inclui pré-requisitos SPFx adicionais que devem ser instalados para desenvolver soluções SPFx, incluindo Node.js, Yeoman e outras ferramentas.

Para saber mais sobre esses pré-requisitos, consulte Configurar seu ambiente de desenvolvimento da Estrutura do SharePoint.

Atualização dos projetos da v1.4 para a v1.4.1

  1. No arquivo package.json do projeto, identifique todos os pacotes SPFx v1.4. Para cada pacote SPFx:

    1. Desinstale o pacote v1.4 existente:

      npm uninstall @microsoft/{spfx-package-name}@1.4

    2. Instale o pacote v1.4.1 existente atualizado:

      npm install @microsoft/{spfx-package-name}@1.4.1.0 --save --save-exact

Dica

A CLI do Microsoft 365 fornece uma orientação passo a passo fácil para atualizar suas soluções para a versão mais recente da Estrutura do SharePoint.

Novas características e recursos

Suporte para Node v8 (LTS) e NPM v5

O suporte para Node.js v8 (LTS) e NPM v5 já está disponível no SPFx.

Problema relatado aqui: https://github.com/SharePoint/sp-dev-docs/issues/1002

Também atualizamos artigo Configure seu ambiente de desenvolvimento da Estrutura do SharePoint.

Novas APIs (visualização do desenvolvedor)

A seguir estão novas APIs disponíveis para uso de visualização no SharePoint Online. Esses não devem ser usados em produção ainda.

@microsoft/sp-http

  • Versão beta inicial da classe AadHttpClient
  • Versão beta inicial da classe AadTokenProvider

@microsoft/sp-client-preview

  • Versão beta inicial da classe MSGraphClient

Você pode encontrar um tutorial para essas novas APIs na documentação de Desenvolvimento do Office SharePoint.

AadHttpClient (versão prévia do desenvolvedor)

AadHttpClient é usada para fazer chamadas REST em um Aplicativo do Azure AD, por exemplo, WebAPI de terceiros hospedado no Azure.

  • Para se comunicar com o SharePoint, use a classe SPHttpClient.
  • Para se comunicar com Microsoft Graph, use a classe MSGraphClient.

Você pode encontrar mais informações sobre essa nova API na documentação de Desenvolvimento do Office SharePoint:

MSGraphClient (versão prévia do desenvolvedor)

MSGraphClient é usado para fazer chamadas REST contra o Microsoft Graph. A biblioteca de clientes Javascript do Microsoft Graph é um wrapper leve em torno da API Microsoft Graph. Essa classe permite que os desenvolvedores iniciem chamadas REST para o MSGraph sem a necessidade de inicializar a biblioteca de clientes do MSGraph.

Se uma configuração personalizada for desejada, a MSGraphClientfunção API precisará ser fornecida com essa configuração personalizada para cada solicitação.

Importante

Observe que essa API está substituindo o GraphHttpClient lançado, que agora é considerado preterido.

AadTokenProvider

Essa classe é uma classe interna usada por AadHttpClient e MSGraphClient para obter tokens OAuth2 do Azure AD. Embora a classe esteja marcada como pública no momento, estamos planejando alterá-la como interna. Por esse motivo, as soluções devem depender apenas das classes AadHttpClient e MSGraphClient.

Mudanças nesta versão

  • Corrigido um problema no gerador que impedia a ativação de novas versões de pacotes SPFx.
  • Sintomas: você implanta uma nova versão dos pacotes da Estrutura do SharePoint e não vê mais suas Web Parts no seletor de Web Parts.

    • #775

    • Correção: para corrigir esse problema com êxito, você precisará executar as seguintes etapas em seus locatários do SharePoint Online.

      1. Remover todas as instâncias de soluções existentes da Estrutura do SharePoint do nível do site
      2. Remover a solução da Estrutura do SharePoint do catálogo de aplicativos
      3. Carregar a nova solução da Estrutura do SharePoint criada com a versão 1.4.1 para o catálogo de aplicativos
      4. Instale as soluções da Estrutura do SharePoint de volta aos sites.

      Observação

      Esse problema não está ocorrendo para soluções da Estrutura do SharePoint no escopo do locatário e não está acontecendo para suplementos do SharePoint.

      Dica

      Você pode potencialmente aproveitar as APIs ALM (Gerenciamento do Ciclo de Vida de Aplicativos) para automatizar esse processo necessário.

Substituição e itens removidos nesta versão

  • A APIGraphHttpClient foi preterida em favor do novo MSGraphClientintroduzido nesta versão. O GraphHttpClient será removido em uma versão futura.