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

Lançaremos vídeos de documentação e diretrizes mais atualizadas durante os próximos dias e semanas. Seus comentários sobre os ativos e tópicos necessários são mais do que bem-vindos.

Lançamento:14 de março de 2019

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.7.1 para a v1.8.0

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

   1. Desinstale o pacote v1.7.1 existente:

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

   2. Instale o pacote v1.8.0 existente atualizado:

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

2. Verifique se há uma entrada na seção devDependency de package.json que faça referência "@microsoft/sp-tslint-rules": "1.8.0".

3. Adicione um pacote @microsoft/rush-stack-compiler-x-x como um devDependency no package.json. Consulte a seção Support for TypeScript 2.7, 2.9 e 3.x (Disponibilidade Geral) para obter detalhes sobre a versão correta a ser usada.

4. Atualize o arquivo tsconfig.json para estender a configuração TypeScript para sua versão do @microsoft/rush-stack-compiler-x-x. Faça isso modificando a parte superior do arquivo da seguinte maneira:

   • Para @microsoft/rush-stack-compiler-2-7, a parte superior do arquivo tsconfig.json seria semelhante

     {
        "extends": "./node_modules/@microsoft/rush-stack-compiler-2.7/includes/tsconfig-web.json",
        "compilerOptions": { // ommitted for brevity }
     }
     

   • Para @microsoft/rush-stack-compiler-3-3, a parte superior do arquivo tsconfig.json seria semelhante

     {
        "extends": "./node_modules/@microsoft/rush-stack-compiler-3.3/includes/tsconfig-web.json",
        "compilerOptions": { // ommitted for brevity }
     }
     

5. Corrija todos os erros de tslint novos e interessantes que estão sendo gerados com um compilador mais recente. Para projetos grandes, isso pode demorar um pouco. O comportamento padrão dos compiladores TypeScript está ficando mais estrito, mas seu código será o melhor para ele.

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

Desenvolvimento de SPFx para guias do Teams (Disponibilidade Geral)

As soluções de guias do Teams que usam SPFx agora têm suporte total. Adicione TeamsTab à propriedade supportedHosts no manifesto da Web Part e implante-a no catálogo de aplicativos. A partir daí, você pode escolher a solução e clicar no botão " Sincronizar com o Teams". A Web Part agora aparecerá como um aplicativo nas equipes. Quando uma Web Part estiver hospedada em uma guia do Teams, ela terá acesso ao SDK do Teams por meio do contexto da Web Part. Existem as seguintes alterações da versão beta em 1.7:

• As configurações iniciais e futuras são tratadas usando o Painel de Propriedades
• A propriedade de manifesto canUpdateConfiguration pode ser definida como false para desabilitar a configuração após a configuração inicial
• Sobrecarga de JavaScript reduzida para hospedar a Web Part
• Recurso “ Sincronizar com o Teams” para automatizar a criação e o upload de manifesto do Teams
• Atualizar teams-js para v1.4.1
• A localidade é controlada pela localidade atual do Teams

Veja mais de:

• Criando guias do Microsoft Teams usando a Estrutura do SharePoint
• Construa a aba Equipes Microsoft usando SharePoint Framework - Tutorial
• Criar o manifesto do Microsoft Teams manualmente em uma Web Part e implantá-lo no Microsoft Teams

Páginas do Aplicativo (Disponibilidade Geral)

Frequentemente, recebemos solicitações para ter uma estrutura de aplicativo de página única no SPFx. Esperamos que as Páginas de Aplicativos atendam à maioria das metas em torno de SPAs, fornecendo um modelo de desenvolvimento e uma experiência do usuário semelhantes. As páginas do aplicativo são um novo layout de página moderna do SharePoint, que hospeda uma única Web Part em toda a página; mantendo a aparência (navegação, cabeçalho, tema e assim por diante) consistente. Adicionar SharePointFullPage à propriedade do manifesto da Web Part adicionará uma Página do Aplicativo com a opção de Web Part ao criar uma nova páginasupportedHosts.

A Web Part pode ser configurada (a menos que a propriedadecanUpdateConfiguration seja false), mas o layout/conteúdo da página não pode ser modificado. A criação de páginas de aplicativos pelo usuário final deve ser lançada posteriormente neste mês com a nova experiência de criação de página. Enquanto isso, há uma página estática (localizada em _layouts/15/appPageHost.aspx?componentId=yourComponentGuidHere) que hospedará qualquer componente em uma página de aplicativo. Esta página está sendo lançada e deve estar disponível no momento do lançamento ou um ou dois dias depois, dependendo do seu locatário.

Veja mais de:

• Usar páginas de aplicativos de parte única no SharePoint Online

Web Parts isoladas do domínio (Disponibilidade Geral)

Os componentes SPFx em execução dentro da página atual são simples e rápidos. No entanto, há cenários em que um nível mais forte de isolamento é desejado. As Web Parts isoladas de domínio são executadas em um iframe com um domínio separado, que pode ter permissões diferentes da página host. Isso permite, por exemplo, que uma Web Part acesse o email do usuário atual sem fornecer a todos os códigos em execução no locatário o mesmo nível de acesso.

O domínio e seu aplicativo do AAD são criados e gerenciados para o locatário. O administrador do locatário precisará aprovar as permissões solicitadas pela solução. Para usuários finais, a Web Part se parece e se comporta como qualquer outra Web Part. Neste momento, as Web Parts isoladas de domínio só dão suporte a Dados Dinâmicos no Contexto da Página. A comunicação completa de parte em parte virá em uma atualização futura.

Veja mais de:

• Web parts isoladas

Componentes da biblioteca (Visualização do Desenvolvedor)

Agora você pode criar bibliotecas que outros componentes SPFx podem referenciar. Elas são um pouco complicadas de usar, portanto, publicaremos um documento separado que as descreve mais detalhadamente. O truque é que você precisa publicar sua biblioteca em um feed npm (interno é bom) para consumi-la.

Veja mais de:

• Usar o tipo de componente de biblioteca na Estrutura do SharePoint
• Criando com soluções com o tipo de componente de biblioteca na Estrutura do SharePoint

Suporte para TypeScript 2.7, 2.9 e 3.x (Disponibilidade Geral)

Nesta versão, separamos a versão do TypeScript da versão do SPFx que você está usando. Agora você pode especificar a versão do TypeScript que deseja usar separadamente do próprio sistema de build. Você pode usar qualquer compilador listado aqui: https://www.npmjs.com/search?q=%40microsoft%2Frush-stack-compiler.

Observação

O compilador que você usa precisa ser refletido no arquivo tsconfig.json, com uma referência a "extends": "./node_modules/@microsoft/rush-stack-compiler-2.7/includes/tsconfig-web.json", que corresponde à versão do compilador rush-stack que você inclui.

Notamos no último momento que algumas das versões recentes dos pacotes @microsoft/rush-stack-compiler não estão funcionando corretamente. Se você descobrir que a instalação do npm fornece avisos sobre dependências par para TypeScript e o build falhará com reclamações de não encontrar um compilador, use uma versão anterior do pacote.

As versões a seguir do @microsoft/rush-stack-compiler devem ser usadas com a versão typeScript correspondente.

• TypeScript v2.7
  • @microsoft/rush-stack-compiler-2.7@0.5.7
• TypeScript v2.9
  • @microsoft/rush-stack-compiler-2.9@0.6.8
• TypeScript v3.0
  • @microsoft/rush-stack-compiler-3.0@0.5.9
• TypeScript v3.3
  • @microsoft/rush-stack-compiler-3.3@0.1.6

Temas variantes da Web Part em páginas modernas do SharePoint

Páginas modernas do SharePoint lançaram recentemente um recurso para ter cores de plano de fundo da seção. As Web Parts podem atualizar seus temas para refletir a cor da tela de fundo que a Web Part está renderizando. Definir a propriedade supportsThemeVariants no manifesto da Web Part como true desabilitará o comportamento padrão de sempre renderizar uma tela de fundo branca.

Em seguida, as Web Parts podem usar o SPFx themeProvider para serem notificadas sobre alterações de cor da tela de fundo.

Veja mais de:

• Suporte a telas de fundo da seção

Mudanças nesta versão

Código PropertyPane removido de @microsoft/sp-webpart-base

Estamos movendo o código do painel de propriedades para um pacote diferente (@microsoft/sp-property-pane) que contém toda a lógica do painel de propriedades que existia anteriormente em @microsoft/sp-webpart-base. As soluções que estão em execução continuarão funcionando (encaminharemos as chamadas adequadamente), mas as APIs de painel de propriedade pública no @microsoft/sp-webpart-base são preteridas no SPFx v1.8 e serão removidas na versão SPFx v1.9.

Suas alterações de código precisam mudar o pacote importado. Elas têm exatamente os mesmos tipos e assinaturas; eles estão localizados em um pacote diferente. Isso nos permite carregar apenas o código do painel de propriedades (e todos os seus pacotes dependentes) somente quando necessário.

Substituição e itens removidos nesta versão

Consumo de malha herdada de CSS

Desde o lançamento do SPFx v1.0, adicionamos um monte de malhas de CSS à página. Embora mudemos o modo como a malha CSS funciona desde então, continuamos adicionando a versão antiga da malha de CSS à página. Isso acabou adicionando uma quantidade considerável de CSS desnecessário. A partir do SPFx 1.8.0, as soluções não carregarão mais a malha de CSS antiga.

Se sua solução ainda precisar do comportamento anterior à 1.8.0, adicione ”loadLegacyFabricCss”: true ao manifesto do componente.

Se os estilos não estiverem funcionando corretamente após a atualização para 1.8.0, talvez seja necessário alternar essa configuração.

Em vez disso, sua solução pode importar a folha de estilos Fabric.css da seguinte maneira:

import 'office-ui-fabric-react/dist/css/fabric.css';

Limitações e problemas conhecidos

A nova experiência do usuário final para criar páginas de aplicativo depende da nova experiência para Adicionar uma página nas páginas modernas. Ela está sendo lançada agora, mas o lançamento em seu locatário pode estar alguns dias atrasado.

Conforme mencionado na seção de suporte typeScript, alguns dos builds mais recentes do @microsoft/rush-stack-compiler que usamos estão tendo problemas. As versões anteriores funcionam. Publicaremos atualizações e notificações quando isso for resolvido.

O modelo de provedor hospedado atualizado para hospedar soluções do Microsoft Teams no SharePoint Online (usando o SDK do Teams) ainda está em versão prévia.

O suporte a dados dinâmicos para partes de domínio isolados é limitado à fonte de dados de contexto de página. O suporte completo para dados dinâmicos no limite do iFrame será fornecido em uma atualização futura.