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.
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).
-
Vá para https://nodejs.org e baixe o instalador do LTS.
-
Execute o instalador e aceite os padrões.
-
Confirme se funcionou abrindo um terminal e executando:
code language-sh node --version npm --versionVocê deve ver os números de versão (por exemplo,
v20.17.0e10.x). -
(Condicional) Se
nodenão for encontrado, feche e reabra o terminal ou reinicie o computador. -
Continue para Instalar o Adobe I/O CLI (
aio).
- 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:
-
Use o seguinte comando
npmna linha de comando.code language-sh npm install -g @adobe/aio-cli -
Confirme se ele foi instalado usando o seguinte comando:
code language-sh aio --versionVocê deve ver algo como
@adobe/aio-cli/11.x.x. -
Prossiga para Fazer logon no Adobe.
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
-
Conecte a CLI à sua conta do Adobe com o seguinte comando:
code language-sh aio login -
Na janela do navegador que é aberta, faça logon com sua Adobe ID e aprove o acesso.
-
Depois que o logon for bem-sucedido, feche a guia do navegador e retorne ao terminal.
-
(Opcional) Para sair mais tarde, (por exemplo, para alternar contas), use o comando:
aio logout. -
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.