Compartilhar via

Depuração de funções personalizadas num runtime não partilhado

Este artigo aborda a depuração apenas para funções personalizadas que não utilizam um runtime partilhado. Para cenários de runtime partilhados, consulte Descrição geral da depuração de Suplementos do Office.

Importante

Observe que as funções personalizadas do Excel estão disponíveis nas plataformas a seguir.

  • Office na Web
  • Office no Windows
    • Assinatura do Microsoft 365
    • revenda perpétua do Office 2016 e posterior
    • Office 2021 perpétuo/LTSC licenciado em volume e posterior
  • Office no Mac

As funções personalizadas do Excel não são atualmente suportadas no seguinte:

  • Office no iPad
  • versões perpétuas licenciadas em volume do Office 2021 ou anterior no Windows

Observação

O manifesto unificado do Microsoft 365 não suporta atualmente projetos de funções personalizadas. Tem de utilizar o manifesto apenas de suplemento para projetos de funções personalizadas. Para obter mais informações, veja Manifesto de Suplementos do Office.

Observação

Recomendamos a utilização de funções personalizadas com um runtime partilhado, a menos que tenha um motivo específico para não utilizar um runtime partilhado. Para obter mais informações sobre runtimes, consulte Runtimes nos Suplementos do Office.

Dica

As técnicas de depuração descritas neste artigo não funcionam com projetos criados com o projeto suplemento do Office que contém a opção apenas manifesto no gerador Yeoman. Os scripts referidos posteriormente neste artigo não são instalados com essa opção. Para depurar um suplemento criado com esta opção, consulte as instruções num dos seguintes artigos, conforme adequado.

O processo de depuração de uma função personalizada para suplementos que não utilizam um runtime partilhado varia consoante a plataforma de destino (Windows, Mac ou Web) e se está a utilizar Visual Studio Code ou um IDE diferente. Utilize as ligações na tabela seguinte para visitar secções deste artigo relevantes para o seu cenário de depuração. Nesta tabela, "CF-NSR" refere-se a funções personalizadas num runtime não partilhado.

Plataforma de destino Visual Studio Code Outro IDE
Excel Online Utilizar o VS Code e as ferramentas de desenvolvimento do browser Utilizar as ferramentas de linha de comandos
Excel no Windows Utilizar o VS Code e as ferramentas de desenvolvimento do browser A depuração do CF-NSR em execução no Excel no Windows fora do VS Code não é suportada. Depurar contra Excel na Web.
Excel no Mac A depuração do VS Code do CF-NSR em execução no Excel no Mac não é suportada. Depurar contra Excel na Web. Utilizar as ferramentas de linha de comandos

Utilizar as ferramentas de programador do browser para depurar funções personalizadas no Excel na Web

Utilize as ferramentas de programador do browser para depurar funções personalizadas que não utilizam um runtime partilhado no Excel na Web. Os passos seguintes funcionam para Windows e macOS.

Executar o suplemento a partir de Visual Studio Code

  1. Abra a pasta do projeto de raiz das funções personalizadas no Visual Studio Code (VS Code).
  2. SelecioneTarefa de Execução de Terminal> e execute Monitorização. Esta ação irá monitorizar e recompilar quaisquer alterações de ficheiro.
  3. SelecioneTarefa de Execução de Terminal> e execute o Dev Server.

Realizar o sideload do seu suplemento

  1. Abra Office na Web.

  2. Abra um novo livro do Excel.

  3. SelecioneSuplementos Base e, em seguida, selecione Mais Definições.>

  4. Na caixa de diálogo Suplementos do Office , selecione Carregar o Meu Suplemento.

  5. Navegue até o arquivo de manifesto do suplemento e selecione Carregar.

    A caixa de diálogo Carregar suplemento com botões para pesquisar, carregar e cancelar.

Observação

Depois de carregar em sideload para o documento, este permanecerá sideload sempre que abrir o documento.

Iniciar a depuração

  1. Abra as ferramentas de programador do browser. No Chrome e na maioria dos browsers, prima F12 para abrir as ferramentas de programador.
  2. Nas ferramentas de programador, abra o ficheiro de script de código fonte com Cmd+P ou Ctrl+P (functions.js ou functions.ts).
  3. Defina um ponto de interrupção no código fonte da função personalizada.

Se precisar de fazer alterações, edite o código no VS Code, guarde o seu trabalho e, em seguida, atualize a página do livro para aplicar a atualização.

Utilizar as ferramentas de linha de comandos para depurar

Se não utilizar o VS Code, execute o suplemento a partir da linha de comandos com ferramentas como o Bash ou o PowerShell. Para depurar o código no Excel na Web, utilize as ferramentas de programador do browser.

  1. A partir da linha de comandos, execute npm run watch para observar e reconstruir quando ocorrerem alterações de código.

  2. Abra uma segunda janela da linha de comandos (a primeira está ocupada durante a execução do relógio).)

  3. Se quiser iniciar o suplemento na versão de ambiente de trabalho do Excel e a secção "scripts" do ficheiro package.json do projeto tiver um script "start:desktop", execute npm run start:desktop; caso contrário, execute npm run start.

    Em alternativa, se preferir iniciar o suplemento no Excel na Web execute o seguinte comando.

    npm run start -- web --document {url} (em que {url} é o URL de um ficheiro do Excel no OneDrive ou SharePoint)

    Observação

    Se estiver a desenvolver num Mac, coloque as {url} aspas simples. Não o faça no Windows.

    Se o suplemento não carregar em sideload no documento, siga os passos em Sideload your add-in (Carregar o suplemento em sideload). Em seguida, avance para a secção seguinte para iniciar a depuração.

  4. Abra as ferramentas de programador do browser. No Chrome e na maioria dos browsers, prima F12 para abrir as ferramentas de programador.

  5. Nas ferramentas de programação, abra o ficheiro de script de código fonte (functions.js ou functions.ts). O código das funções personalizadas pode estar localizado perto do fim do ficheiro.

  6. No código fonte da função personalizada, aplique um ponto de interrupção ao selecionar uma linha de código.

Se precisar de alterar o código, pode efetuar edições no VS Code e guardar as alterações. Atualize o browser para ver as alterações carregadas.

Comandos para criar e executar o suplemento

Tarefas de compilação disponíveis:

  • npm run watch: criações para desenvolvimento e reconstrói automaticamente quando um ficheiro de origem é guardado
  • npm run build-dev: criações para desenvolvimento uma vez
  • npm run build: builds for production (construções para produção)
  • npm run dev-server: executa o servidor Web utilizado para desenvolvimento

Utilize estas tarefas para iniciar a depuração:

  • npm run start:desktop: inicia o Excel no ambiente de trabalho e efetua sideloads do seu suplemento. Se o script "start:desktop" não estiver presente na secção "scripts" do ficheiro package.json do projeto, execute npm run start em vez disso.

  • npm run start -- web --document {url}(em que {url} é o URL de um ficheiro do Excel no OneDrive ou SharePoint): inicia Excel na Web e faz sideloads do seu suplemento.

    Observação

    Se estiver a desenvolver num Mac, coloque as {url} aspas simples. Não o faça no Windows.

  • npm run stop: para o Excel e a depuração.

Próximas etapas

Saiba mais sobre a Autenticação para funções personalizadas sem um runtime partilhado.

Confira também

  • Last updated on