# Toolchain SPFx: Atualizar, Substituir ou Congelar | AvantIT > O SPFx passou de gulp para Heft, a 1.24 traz React 18 e uma nova CLI substitui o Yeoman. Como decidir por web part, e o fim do Project Online a 30 de setembro. Canonical: https://www.avantit.pt/pt/newsletter/web-parts-ainda-funcionam-consegue-compila-las/ Source: AvantIT — https://www.avantit.pt (Microsoft Partner, Matosinhos, Portugal) --- [Todas as edições](https://www.avantit.pt/pt/newsletter/) AvantIT Insider · Edição 3 # As Suas Web Parts Ainda Funcionam. Ainda Consegue Compilá-las? ![Arsénio Ferraz] Arsénio Ferraz 2026-09-28 6 min ![Capa da AvantIT Insider: as suas web parts personalizadas de SharePoint ainda funcionam, a questão é se alguém ainda as consegue compilar. Cronologia do SPFx de gulp para Heft, SPFx 1.24 com React 18, uma nova CLI a substituir o Yeoman e o fim do Online Workbench a 1 de dezembro, com quatro opções: atualizar, out-of-the-box, reconstruir e congelar] A maioria das web parts personalizadas de SharePoint nas PME europeias foi construída uma vez, instalada e esquecida. Continuam a funcionar. Mas peça a alguém para mudar uma etiqueta e voltar a compilar uma delas, e pode descobrir que a toolchain com que foi construída já não existe nessa forma. Entre dezembro de 2025 e o início de 2027, a Microsoft está a substituir quase todas as peças da stack de desenvolvimento da SharePoint Framework (SPFx). ## O que saiu (e o que vai desaparecer) O Project Online termina esta quarta-feira, 30 de setembro. A partir dessa data, os sites do Project Web App (PWA) e os respetivos dados deixam de estar acessíveis. Não há período só de leitura, e não foi anunciada nenhuma extensão. A Microsoft encaminha os clientes para o Planner (que agora absorve o Project for the web), o Project Server Subscription Edition ou o Project desktop. Para uma PME: se alguém ainda abre um site PWA, exporte hoje os planeamentos, as folhas de horas e os documentos. A migração pode esperar algumas semanas. A exportação não. (Microsoft Tech Community) O SPFx 1.24 está em beta, com disponibilidade geral (GA) prevista para outubro de 2026. O destaque é o suporte a React 18, o pedido mais frequente da história da framework, segundo a Microsoft. A mesma atualização do roadmap confirma que uma nova CLI (interface de linha de comandos) do SPFx substitui o gerador Yeoman na versão 1.25, prevista para dezembro de 2026 ou janeiro de 2027. Em paralelo, o SPFx Online Workbench termina a 1 de dezembro de 2026. Para uma PME: nada deixa de funcionar em produção, mas cada web part personalizada vai precisar de uma passagem pela toolchain da próxima vez que alguém lhe mexer. (Roadmap do SPFx, agosto de 2026, anúncio do SPFx 1.23) O Copilot Studio passa a mostrar o custo dos agentes, em pré-visualização pública. Os makers vão ver o custo de consumo por agente no separador Monitor, além do custo das avaliações e dos chats de teste (IDs do Microsoft 365 Roadmap 571196, 571195, 571194). Para uma PME: os agentes faturados por consumo têm sido difíceis de orçamentar. Esta é a primeira forma nativa de ver quanto custa cada agente antes de a fatura chegar. É uma pré-visualização, por isso confira os números com a sua faturação real. ## Em foco: quando uma web part personalizada deixa de compensar A situação. Um tenant típico de uma PME tem entre cinco e quinze web parts personalizadas, construídas por pessoas diferentes ao longo dos anos: um carrossel de notícias, um mosaico de KPI, um formulário de pedidos, um explorador de documentos. A maioria foi construída em versões do SPFx entre a 1.11 e a 1.18, com gulp, React 16 ou 17, e Node.js 14 a 18. Funcionam. O problema aparece no dia em que alguém pede uma alteração. Desde o SPFx 1.22 (dezembro de 2025), a toolchain de build passou de gulp para Heft. A própria documentação da Microsoft avisa que atualizar simplesmente o package.json de um projeto antigo vai provocar falhas de build, e aponta antes para o comando de upgrade da CLI for Microsoft 365. O SPFx 1.22 e versões seguintes esperam Node.js 22 LTS (suporte de longo prazo). O SPFx 1.24 acrescenta React 18. Assim, uma “alteração de quinze minutos a uma etiqueta” numa web part de 2019 pode transformar-se em dois dias de arqueologia de toolchain. As opções. Há quatro caminhos honestos para cada web part: - Atualizar e manter. Levá-la para a versão atual do SPFx e mantê-la. - Substituir por funcionalidades nativas (out-of-the-box, OOTB). O SharePoint moderno absorveu muita coisa: Conteúdo em destaque, Ligações rápidas, Eventos, formatação de listas, Brand Center. - Reconstruir noutra superfície. Power Apps para formulários com aprovações, ou um Copilot Component (ainda em pré-visualização) para aquilo a que as pessoas devem chegar a partir do Copilot. - Congelar. Não lhe mexer, documentá-la e aceitar o risco. Os critérios. Atualize quando a web part tem lógica de negócio que o OOTB não consegue fazer, é usada todas as semanas e espera alterá-la nos próximos doze meses. Substitua por OOTB quando é sobretudo apresentação: carrosséis, grelhas de ligações, listas com estilo. Uma boa parte das web parts da era de 2018 a 2021 cai neste grupo. Reconstrua em Power Apps quando é, na verdade, um formulário com uma aprovação por trás. Congele apenas quando é estável, pouco usada e ninguém vai pedir alterações, e marque-lhe uma data de revisão. O custo escondido. Não é a atualização. É o código-fonte. Muitas PME não o têm. O pacote está no catálogo de aplicações, e o código-fonte vive no portátil de um antigo fornecedor. Sem código-fonte, não há caminho de atualização: só substituir ou congelar. O segundo custo escondido são as bibliotecas de terceiros (versões antigas do Fluent UI ou dos PnP controls) presas ao React 17, que podem bloquear a passagem para React 18 mesmo quando o seu próprio código está bem. O que faríamos. Inventário primeiro, decisão web part a web part, e atualizar apenas as que o merecem. Para essas, esperar pela GA do SPFx 1.24 e atualizar uma só vez, em vez de ir agora para a 1.23 e outra vez daqui a um mês. Imagine uma empresa de 60 pessoas com doze web parts personalizadas: numa revisão típica, três ou quatro merecem ser atualizadas, a maioria das restantes passa a páginas OOTB numa tarde, e uma ou duas são formulários que deviam ter sido Power Apps desde o início. ## Faça esta semana - Se ainda usa o Project Online, abra hoje todos os sites PWA e exporte os planos de projeto, as folhas de horas e os documentos anexos antes de quarta-feira. - Faça a lista das suas soluções personalizadas. No centro de administração do SharePoint, vá a Mais funcionalidades, depois Aplicações, e abra o catálogo de aplicações. Anote cada pacote personalizado e, ao lado de cada um, quem tem o código-fonte. - Peça a versão do SPFx de cada um. O seu programador ou parceiro consegue lê-la no ficheiro .yo-rc.json do projeto em minutos. Tudo o que esteja abaixo da 1.22 está na toolchain antiga de gulp. Diga-nos quantas web parts personalizadas tem o seu tenant, e se tem o código-fonte de todas. As respostas costumam ser mais interessantes do que as pessoas esperam. Esta edição foi publicada originalmente na newsletter [AvantIT Insider no LinkedIn](https://www.linkedin.com/posts/arsenioferraz_your-custom-sharepoint-web-parts-still-run-ugcPost-7510325822713430017-PnuB). Comentários e discussão acontecem lá. Partilhar: [Subscrever no LinkedIn](https://www.linkedin.com/posts/arsenioferraz_your-custom-sharepoint-web-parts-still-run-ugcPost-7510325822713430017-PnuB) ## Outras edições [Edição 4 O OneDrive de Quem Saiu Está em Contagem Decrescente Se alguém saiu da sua empresa antes de julho e lhe retirou a licença, o OneDrive dessa pessoa está provavelmente já arquivado. Ninguém o consegue abrir, nem um administrador, até alguém pagar. E a partir de julho de 2027, a Microsoft pode começar a eliminá-lo.](https://www.avantit.pt/pt/newsletter/contagem-decrescente-onedrive-sem-licenca/)[Edição 2 A Fatura dos Conectores Premium que Ninguém Antecipa Um fluxo corre durante meses com conectores standard. Alguém acrescenta uma ação de SQL Server e, de repente, todos os colaboradores que o executam precisam de uma licença premium. Ninguém dá por isso até chegar a fatura.](https://www.avantit.pt/pt/newsletter/fatura-conectores-premium-que-ninguem-antecipa/) [Ver todas as edições](https://www.avantit.pt/pt/newsletter/) ### Receba a próxima edição por email Uma edição por semana sobre Microsoft 365, SharePoint, Power Platform e IA aplicada a PMEs. Subscrever Pode cancelar a subscrição a qualquer momento através do link no rodapé de cada email. ### Isto aplica-se ao seu tenant? Fale connosco e revemos o seu caso concreto, sem compromisso. ### Envie-nos uma mensagem Preencha o formulário abaixo e entraremos em contacto brevemente. Nome Email Empresa Telefone Função ( opcional ) Selecione Direção / Administração TI / Tecnologia Financeiro Operações Recursos Humanos Marketing / Vendas Outro Dimensão da empresa ( opcional ) Selecione 1-5 colaboradores 5-25 colaboradores 25-50 colaboradores 50-100 colaboradores 100-500 colaboradores 500-1000 colaboradores 1000+ colaboradores Serviço de Interesse Selecione um serviço Desenvolvimento de Software Intranets SharePoint Power Platform Data & AI Consultoria Suporte Mensagem Quero receber ocasionalmente conteúdos da AvantIT sobre Microsoft 365, Power Platform e automação. Usamos os seus dados apenas para responder a este pedido. [Política de Privacidade](https://www.avantit.pt/pt/privacy/) Enviar Mensagem