Bibliotecas e ferramentas de desenvolvimento da Estrutura do SharePoint

O SharePoint Framework inclui várias bibliotecas de JavaScript do lado do cliente que você pode usar para criar soluções. Este artigo fornece uma visão geral sobre as ferramentas e bibliotecas que você pode usar para desenvolver Web Parts do lado do cliente.

TypeScript

TypeScript é um superconjunto tipado de JavaScript que é compilado para JavaScript simples. As ferramentas de desenvolvimento do lado do cliente do SharePoint são criadas usando classes, módulos e interfaces TypeScript. Você pode usá-los para criar Web Parts do lado do cliente robustas.

Para começar a usar TypeScript, confira os seguintes recursos:

Estruturas JavaScript

Você pode escolher qualquer uma das várias estruturas JavaScript para desenvolver Web Parts do lado do cliente. Estas são algumas das mais populares:

Como Web Parts do lado do cliente são componentes incluídos em uma página do SharePoint, recomendamos que você escolha uma estrutura JavaScript que dê suporte a um modelo de componente semelhante. Estruturas leves, como React, Handlebars e Angular 2, dão suporte a um modelo de componente e são adequadas para criar Web Parts do lado do cliente.

Também recomendamos que você confira a Biblioteca do SharePoint PnP JavaScript Core, que é uma iniciativa da comunidade para fornecer acesso fácil a APIs REST do SharePoint.

npm (Gerenciador de Pacotes de Nós)

As ferramentas de desenvolvimento do lado do cliente do SharePoint usam o gerenciador de pacotes npm, que é semelhante ao NuGet, para gerenciar dependências e outross auxiliares JavaScript obrigatórios. O npm é normalmente incluído como parte da instalação do Node.js.

Para obter mais informações sobre o npm, confira a documentação do npm.

Node.js

Node.js é um ambiente de execução de software livre de plataforma cruzada para hospedar e servir código JavaScript. Você pode usar o Node.js para desenvolver aplicativos Web do lado do servidor escritos em JavaScript. O ecossistema Node.js está intimamente associado ao npm e a executores de tarefas, como gulp, para fornecer um ambiente eficiente para criar aplicativos baseados em JavaScript. O Node.js é semelhante a IIS Express ou IIS, mas inclui ferramentas para simplificar o desenvolvimento do lado do cliente.

Para obter mais informações sobre o Node.js, confira o seguinte:

Executor de tarefas do Gulp

As ferramentas de desenvolvimento do lado do cliente do SharePoint usam gulp como o executor de tarefas de processo de build para:

  • Agrupar e diminuir os arquivos CSS e JavaScript.
  • Executar ferramentas para chamar as tarefas de agrupamento e diminuição antes de cada criação.
  • Compilar arquivos LESS ou Sass para CSS.
  • Compilar arquivos TypeScript para JavaScript.

Para obter mais informações sobre o gulp, confira o seguinte:

Webpack

O Webpack é um empacotador de módulo que considera seus arquivos de Web Parts e dependências e gera um ou mais conjuntos de JavaScript para que você possa carregar diferentes pacotes para diferentes cenários.

A cadeia de ferramentas de desenvolvimento utiliza Webpack para o empacotamento. Isso permite que você defina módulos e onde deseja usá-los. A cadeia de ferramentas também usa SystemJS, um carregador de módulos universal, para carregar seus módulos. Isso ajuda a criar um escopo como Web Parts, garantindo que cada Web Part seja executada em seu próprio namespace.

Para saber mais sobre o Webpack, confira:

Geradores do Yeoman

O Yeoman ajuda a iniciar novos projetos, fornecendo práticas recomendadas e ferramentas para ajudá-lo a se manter produtivo. O gerador Yeoman do SharePoint está disponível como parte da estrutura para início rápido de novos projetos de Web Parts do lado do cliente.

Para obter mais informações sobre o Yeoman, confira o seguinte:

A seguir estão alguns geradores Yeoman comuns que você pode experimentar, dependendo da estrutura que escolher:

Editores de código-fonte

A Estrutura do SharePoint é voltada para o cliente e, assim, você pode usar sua seleção de editores de código HTML/JavaScript, como:

A documentação da Estrutura do SharePoint usa o Visual Studio Code nos documentos e exemplos. O Visual Studio Code é um editor de código-fonte leve e eficiente da Microsoft que é executado na sua área de trabalho e está disponível para Windows, Mac e Linux. Ele vem com suporte integrado para JavaScript, TypeScript e Node.js e possui um rico ecossistema de extensões para outros idiomas (como C++, C#, Python, PHP) e tempos de execução.

APIs REST do SharePoint

O SharePoint Framework fornece integrações-chave com experiências do SharePoint e direciona o desenvolvimento da Web. As APIs REST do SharePoint permitem que você interaja com o SharePoint e outras cargas de trabalho que moldam a funcionalidade da Web Part.

Recomendamos que você se familiarize com o seguinte conjunto de APIs REST:

Padrões e Práticas

A iniciativa Padrões e Práticas de Desenvolvimento do Office / Padrões e Práticas do SharePoint (PnP) fornece amostras de código, padrões e outros recursos para ajudá-lo a transformar sua solução existente para a Estrutura do SharePoint. Certifique-se de se familiarizar com os exemplos de código e as orientações disponíveis por meio do esforço PnP.

Confira também