Configurar ferramentas e conta de extensão da interface do usuário

Antes de criar uma Extensão de interface do usuário para o Workfront Fusion, é necessário configurar as ferramentas e a conta. Isso só precisa ser feito uma vez.

NOTE
Este artigo presume alguma familiaridade com ferramentas de desenvolvimento de software.

Pré-requisitos

Para configurar as ferramentas de extensibilidade da interface do usuário e a conta do, é necessário o seguinte:

  • Uma Adobe ID com acesso a uma organização da Adobe. Esta é a conta que você usa para fazer logon no Fusion.

  • Acesso de desenvolvedor ao App Builder. O administrador da sua organização pode precisar conceder a você a função Desenvolvedor e adicionar você a um Perfil de Produto que inclua o App Builder. Se os comandos falharem posteriormente com “você não é um desenvolvedor” ou não puder ver sua organização, peça ao administrador da organização da Adobe para adicioná-lo.

  • Um Administrador do Sistema (possivelmente alguém na sua equipe) para a etapa final de lançamento. Criar e implantar precisa apenas da função de Desenvolvedor, mas enviar uma extensão para aprovação/publicação requer a função de Administrador do Sistema.

    Para obter mais informações sobre níveis de acesso do Adobe, consulte
    Como obter acesso na documentação do Adobe.

  • Um computador no qual você pode instalar o software e executar comandos de terminal (macOS, Windows ou Linux).

Instalar Node.js

A ferramenta Adobe é executada em Node.js. Você deve instalar a versão LTS (18 ou 20).

  1. Vá para https://nodejs.org e baixe o instalador do LTS.

  2. Execute o instalador e aceite os padrões.

  3. Confirme se funcionou abrindo um terminal e executando:

    code language-sh
    node --version
    npm --version
    

    Você deve ver os números de versão (por exemplo, v20.17.0 e 10.x).

  4. (Condicional) Se node não for encontrado, feche e reabra o terminal ou reinicie o computador.

  5. Continue para Instalar o Adobe I/O CLI (aio).

TIP
  • Se você trabalhar com várias versões de Nó, um gerenciador de versão como o nvm é conveniente, mas é opcional.
  • A CLI do Adobe requer o Nó 18 ou mais recente. Versões muito novas, que não são LTS, podem causar problemas ocasionalmente. Portanto, recomendamos o uso de LTS.

Instalar a CLI do Adobe I/O (aio)

A ferramenta de linha de comando usada para criar, compilar e publicar sua extensão é chamada aio.

Para instalá-lo globalmente:

  1. Use o seguinte comando npm na linha de comando.

    code language-sh
    npm install -g @adobe/aio-cli
    
  2. Confirme se ele foi instalado usando o seguinte comando:

    code language-sh
    aio --version
    

    Você deve ver algo como @adobe/aio-cli/11.x.x.

  3. Prossiga para Fazer logon no Adobe.

NOTE
Se você vir um erro de permissões no macOS/Linux, não use sudo. Em vez disso, corrija as permissões de pasta global do npm ou use um gerenciador de versão de Nó que é instalado em seu diretório inicial.

Fazer logon no Adobe

  1. Conecte a CLI à sua conta do Adobe com o seguinte comando:

    code language-sh
    aio login
    
  2. Na janela do navegador que é aberta, faça logon com sua Adobe ID e aprove o acesso.

  3. Depois que o logon for bem-sucedido, feche a guia do navegador e retorne ao terminal.

  4. (Opcional) Para sair mais tarde, (por exemplo, para alternar contas), use o comando: aio logout.

  5. Continue em Confirmar sua organização ativa.

Confirmar sua organização ativa

Verifique em qual organização a CLI é apontada:

aio console org list      # see organizations you can use
aio console where         # see your currently selected org/project/workspace

Se você pertencer a várias organizações, selecione a correta:

aio console org select

Agora você está pronto para criar o projeto.

recommendation-more-help
workfront-fusion-help-workfront-fusion