Compartilhar via

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

  • Artigo

Bem-vindo à Disponibilidade Geral do SPFx 1.0. Foi uma viagem interessante e empolgante até agora e continuará sendo. Essa é apenas a primeira versão – espere um fluxo estável de melhorias e recursos.

Lançamento: 22 de fevereiro de 2017

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 de versões prévias para v1.0.0

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

    1. Desinstale o pacote pre-v1 existente:

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

    2. Instale o pacote v1.0.0 existente atualizado:

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

Você pode obter os pacotes npm atualizados e usá-los no workbench local, e tudo deve estar certo. No entanto, a distribuição do código para os servidores será feita em estágios ao longo de vários dias. Em algum momento na próxima semana, 100% dos farms devem tê-los. Fazemos isso para monitorar a distribuição e garantir que não temos problemas.

Posso usar o SPFX e as web parts do lado do cliente agora?

Há duas coisas diferentes em jogo. Um é o código que está disponível em todos os farms, o segundo é o recurso que está sendo habilitado para um determinado locatário.

Semelhante a como o código é distribuído entre os farms, o recurso será distribuído para locatários. Vamos começar com os mesmos locatários de primeiro lançamento (não usuários, locatários) que têm o SPFX hoje. Ao longo de algumas semanas, ele deve ser distribuído para todos os locatários.

Você saberá se ele atingiu um determinado locatário porque carregar o pacote no catálogo de aplicativos dirá que ele é válido. Mesmo locatários que não podem carregar pacotes ainda podem experimentar o SPFx, eles serão limitados apenas ao workbench local e hospedado (encontrado em _layouts/15/workbench.aspx).

Mudanças nessa versão

  • Há apenas algumas alterações no código real da Estrutura do SharePoint. A maior parte do nosso trabalho entre RC0 e GA teve a ver com estabilidade e revisão de texto futura. É nossa meta explícita que as partes que você cria hoje continuem a funcionar nos próximos anos. Mas as correções feitas no serviço subjacente continuam a ser fornecidas sem problemas, não temos sete versões secundárias e de patch diferentes do código da estrutura carregadas e assim por diante. Ainda há algum trabalho a fazer nessa área para alguns componentes– vamos chegar a eles.
  • A maior alteração no código em si é que incorporamos o sinalizador de verificações nulas estritas no SPFX, o que significa que você também pode habilitar esse sinalizador em seus projetos. Ela alterou ligeiramente a API, mas só deverá ser observada se você mesmo habilitar verificações nulas estritas.
  • As outras alterações perceptíveis estão no código padrão gerado pela execução do gerador Yeoman. v1.0.0 é a versão dos pacotes. Agora fazemos referência a @types/* com uma versão estrita (sem mais erros de lodash).
  • Temos suporte a XML de recursos (juntamente com a atualização). Isso pode ser usado para provisionar campos, tipos de conteúdo e listas necessárias para a web part no “modo” elevado. Escreveremos algumas postagens sobre isso mais detalhadamente.
  • Finalizamos o formato de serialização em páginas clássicas. Você deve excluir e adicionar novamente suas web parts. Vamos dar suporte ao formato de serialização antigo por um curto período e, em seguida, ele deixará de funcionar.
  • require('./config/docs.config.html'); agora retorna objeto em GA em vez de cadeia de caracteres como RC0

Problemas conhecidos

Removemos temporariamente o office-ui-fabric-react do modelo react até que façamos com que o pacote seja movido para um formulário à prova de futuro. Esperamos que isso leve algumas semanas.