Partilhar via

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

  • Artigo

Esta versão apresenta um novo evento de propriedade & na API da Web Part para detectar a largura de renderização (e alterações), o suporte aprimorado para soluções do Microsoft Teams e atualiza versões com suporte de Node.js.

Lançado: 28 de abril de 2021

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.11.0 para v1.12.1

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

    1. Desinstale o pacote v1.11.0 existente:

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

    2. Instale o pacote v1.12 {version-release} atualizado:

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

  • O botão Sincronizar com o Teams no Catálogo de Aplicativos do Locatário usará o manifesto do aplicativo Teams definido na solução, se presente, para criar e publicar um pacote de aplicativo do Teams no Microsoft Teams. Se um arquivo de manifesto de aplicativo não estiver presente, o SharePoint gerará um dinamicamente.
  • Uma nova API foi adicionada à classe da web part SPFx para determinar a largura renderizada de uma web part e, opcionalmente, manipular um evento quando ela for alterada.
  • Expandir as notificações de listas para trabalhar tanto para listas como para bibliotecas de documentos.
  • Suporte preliminar para aplicativos de reunião do Microsoft Teams com a Estrutura do SharePoint. O suporte completo está aguardando uma correção para regressão do lado do servidor

Mudanças nesta versão

  • Adicionar suporte para Node.js v12.13.x & v14.15.x
    • Veja Configurar o ambiente de desenvolvimento da Estrutura do SharePoint para obter mais detalhes.
    • Gulp-CLI é altamente recomendado. Nossa diretriz anterior era instalar o Gulp v3 ou v4 globalmente, mas a diretriz da equipe do Gulp é instalar somente o Gulp CLI globalmente. Ao usar o Gulp CLI, você pode ter projetos que usam o Gulp v3 e outros que usam o Gulp v4.
  • Para todos os projetos:
  • Para projetos que usam React:
    • Atualize os pacotes React NPM (react&react-dom) para v16.9.0.
    • Atualize o pacote Office UI Fabric React NPM / Microsoft Fluent UI (office-ui-fabric-react) para v7.156.0.
  • O local padrão para os recursos usados em implantações mudou de ./temp/deploy para ./releases/assets. Para projetos criados antes do SPFx v1.12.1, você deve atualizar a propriedade do arquivo workingDir./config/deploy-azure-storage.json para o novo local:"workingDir": "./release/assets/". Para obter mais informações, consulte Implantar a Web Part do lado do cliente do SharePoint na CDN do Azure: Configurar detalhes da conta de armazenamento do Azure.

Substituição e itens removidos nesta versão

  • O Gulp v3 não tem suporte (nem globalmente nem localmente instalado) ao usar o Node.js v12+.

  • A workbench local está preterido. Esta é a última versão que incluirá suporte para o workbench local.

  • Essa é a última versão que incluirá um único gerador que funciona no local e no SharePoint Online. Você ainda poderá criar projetos no local, apenas usando o gerador mais antigo.

  • A tarefa gulp serve foi descontinuada e renomeada como serve-deprecated. Para resolver isso, o gulpfile.js em novos projetos SPFx v1.12.1 foi atualizado para adicionar um alias serve para a tarefa renomeada serve-deprecated. No entanto, se você estiver atualizando um projeto para SPFx v1.12.1, será necessário editar seu arquivo gulpfile.js para que a tarefa gulp serve continue a funcionar.

    Ao atualizar projetos SPFx para v1.12.1, adicione o seguinte antes da linha build.initialize(require('gulp'));:

    var getTasks = build.rig.getTasks;
build.rig.getTasks = function () {
  var result = getTasks.call(build.rig);

  result.set('serve', result.get('serve-deprecated'));

  return result;
};

Versões & gulp Node.js v12+

O Gulp v3 não tem suporte no Node.js v12+ (ref gulpjs/gulp/#2324).

Isso não é uma alteração no SPFx. É mencionado aqui para chamar a atenção para isso, uma vez que essa versão de SPFx adiciona suporte ao Node.js v12.