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

Artigo
03/21/2023

As principais alterações são em torno da introdução do novo modelo plusbeta e muitas outras melhorias e recursos adicionais.

Lançamento: 5 de junho 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 de v1.4.1 para v1.5

No arquivo package.json do projeto, identifique todos os pacotes SPFx v1.4.1. Para cada pacote SPFx:
1. Desinstale o pacote v1.4.1 existente:
```
npm uninstall @microsoft/{spfx-package-name}@1.4.1
```
2. Instale o pacote v1.5 existente atualizado:
```
npm install @microsoft/{spfx-package-name}@1.5.0 --save --save-exact
```

Instale os seguintes pacotes de declaração do tipo TypeScript:

npm install **\@types/webpack-env@1.13.1
npm install **\@types/es6-promise@0.0.33

Adicione as seguintes entradas à matriz types no arquivo tsconfig.json :

{
  // omitted for brevity
  "types": [
    // omitted for brevity
    "webpack-env",
    "es6-promise"
  ]
  // omitted for brevity
}

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

As APIs Beta versus as de envio agora são pacotes separados

A partir da versão v1.5.0, os pacotes conterão apenas as APIs públicas finais nos arquivos *.d.ts . Todas as APIs beta foram removidas e você precisará escolher explicitamente os pacotes contendo APIs beta. Para usar essas APIs beta, é preciso usar as versões 1.5.0-plusbeta dos pacotes. Há apenas uma versão do @microsoft/gerador-sharepoint e ela pode criar soluções beta e não beta.

Crie soluções que usam as APIs beta de uma das duas formas. Execute o gerador yeoman e adicione um sinalizador --plusbeta na linha de comando, e ele logo criará um arquivo package.json com as versões-plusbeta, ou você atualize as referências em package.json para usar a versão -plusbeta.

Isso é diferente da abordagem típica, devido ao fato de que, embora ocasionalmente haja alguns pacotes que são beta, também é comum que algumas APIs beta estejam em pacotes de remessa existentes. Também não é necessariamente verdade que seja uma versão beta do próximo lançamento, pois um recurso pode permanecer como visualização por mais de um lançamento.

Experimentar as funcionalidades da visualização da Estrutura do SharePoint

Dados Dinâmicos (visualização do desenvolvedor )

A parte principal dessa versão é a visualização do desenvolvedor de dados dinâmicos. Pense nisso como uma versão moderna do recurso Conexões entre Web Parts nas páginas clássicas.

O objetivo final do recurso será permitir que desenvolvedores e usuários tenham propriedades mais dinâmicas e possam ser vinculados a propriedades em outras Web Parts (por exemplo, um cartão de usuário que é direcionado pelo documento selecionado atualmente em uma Web Part de biblioteca de documentos), no estado da página (o cartão do usuário exibe o autor) ou no contexto da página (o cartão do usuário exibe o usuário atual).

Esse visualização do desenvolvedor tem enfoque maior no modelo de dados subjacentes. Nenhuma Web Parts primária está expondo propriedades no momento. Temos um objeto de contexto de página de exemplo e um controle de painel de propriedade aproximado (focado no desenvolvedor) onde você pode digitar o caminho para a propriedade dinâmica à qual deseja associar uma propriedade da Web Part.

Ainda estamos trabalhando na experiência do usuário final, mas gostaríamos que os desenvolvedores experimentassem isso no meio tempo. Encontre tutoriais e exemplos nos seguintes locais:

Suporte para gerenciadores de pacotes adicionais (Yarn & PNPM)

O gerador Yeoman e as ferramentas de compilação agora oferecem suporte aos gerenciadores de pacotes PNPM e Yarn, e para npm.

Para usar isso, coloque a opção de linha de comando --package-manager no gerador e especifique npm, **pnpm, ou yarn.

Por exemplo:

yo @microsoft/sharepoint --package-manager pnpm

Gerador Yeoman para a Estrutura do SharePoint

Suporte para Geradores do Yeoman personalizados

O gerador foi retrabalhado para seguir as práticas recomendadas. Isso permitirá que você aproveite o nosso gerador para seus próprios geradores personalizados. Vamos começar uma nova iniciativa de open-source sobre isso na comunidade de desenvolvedores do SharePoint (PnP) para oferecer novas plataformas com suporte, como Angular Elements e Vue.js.

Mudanças nesta versão

Muitas das atualizações da estrutura não requerem uma atualização dos pacotes npm. Por exemplo, removemos o pop-up de autenticação na versão inicial do código de visualização do desenvolvedor da API Web, mas a mudança é implementada na estrutura hospedada no serviço, portanto, nenhuma mudança é necessária para os desenvolvedores.

Houve algumas atualizações que requerem explicitamente atualizações para os pacotes:

Informações de AAD adicionadas ao PageContext (aadInfo)
Corrigido problemas relacionados a sp-dialog e outros pacotes que não funcionavam corretamente no ambiente de trabalho
Adicionadas dez regras tslint extras do tslint-microsoft-config para detectar vulnerabilidades de segurança comuns
Corrigido um problema na solução de pacote em que os avisos faziam com que a compilação falhasse incorretamente

Compartilhar via