Compartilhar via

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

  • Artigo

Esta versão contém dois recursos principais:

  • A versão final do recurso WebAPI foi visualizada pela primeira vez na v1.4.1
  • Suporte para extensões a serem configuradas em todo o locatário sem a necessidade de ativar ou configurar todos os sites.

Lançado: 5 de setembro 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.

Atualizando projetos da v1.5.1 para a v1.6

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

    1. Desinstale o pacote v1.5.1 existente:

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

    2. Instale o pacote v1.6 atualizado:

      npm install @microsoft/{spfx-package-name}@1.6.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

API Web (disponibilidade geral)

Para o recurso WebAPI, há algumas alterações introduzidas no trabalho de GA (disponibilidade geral). Todo o acesso aos recursos protegidos do AAD é tratado por um aplicativo do AAD de terceiros e uma entidade de serviço. O aplicativo é criado na primeira vez que um administrador de locatário aprova um escopo de permissão e é criado sem permissões. Portanto, qualquer conexão feita aos dados (por meio do Microsoft Graph ou uma chamada para um ponto de extremidade que usa o AAD para suas permissões) precisa ser explicitamente permitida.

Importante

A permissão que foi concedida anteriormente à versão v1.6.0 precisará ser concedida novamente, pois alteraremos qual aplicativo do AAD é usado.

  • Use o MSGraphClient. Ele existe no contexto do componente (web part ou extensão). Por motivos de desempenho, o código completo é carregado sob demanda, portanto, ele é acessado por meio de uma promessa.
  • Stop usando GraphHttpClient (se você ainda não tiver parado). Em algum momento no próximo mês ou então, vamos removê-lo completamente do nosso código. Todas as soluções que você tiver que usá-la deixarão de funcionar.
  • Semelhante a MSGraphClient, há um AadHttpClient do contexto para fazer chamadas para pontos de extremidade protegidos do AAD e um AadTokenProvider que você pode usar para obter tokens de autenticação manualmente.

Implantação de extensões em todo o locatário

Agora você pode fazer configurações de todo o locatário para extensões. A maneira mais fácil (como desenvolvedor) de implantar na locação é modificar o arquivo \SharePoint\ClientInstance.xml (criado com uma nova solução v1.6.0). Isso cria uma entrada em uma nova lista no catálogo de aplicativos (Extensões de Todo o Locatário). Você também pode modificar essa lista diretamente como um proprietário do catálogo de aplicativos.

Mudanças nesta versão

Alterações de compilação e ferramentas

Estamos tentando sair de alguns dos wrappers em torno de ferramentas de build comuns. Os dois primeiros são as etapas do compilador tslint e ts. Devido a essas alterações, o código anterior não será compilado sem algumas alterações.

  • Primeiro, você precisa ter um arquivo *.ts na raiz do diretório de origem (por padrão, agora criamos um em \src chamado index.ts que está vazio).
  • Em segundo lugar, o arquivo tslint.json alterou o local (de \config para a raiz do projeto) e formato. agora é apenas um arquivo tslint.json. A coisa mais fácil de fazer é criar um novo projeto e copiar o arquivo tslint.json dele.
  • Em terceiro, pegue o arquivo tsconfig.json da raiz do novo projeto na etapa 2 e copie-o para a raiz do projeto original. Se você tiver feito alterações no arquivo tsconfig.json, convém mescle-os.

Promoção de classes CSS para disponibilidade geral

Encontramos algumas classes no pacote @microsoft/sp-dialog que foram marcadas como Beta. Nós os movemos para o público.

Observação

Esta é a última versão em que as ferramentas de build darão suporte ao Node.js v6.