Introdução à CLI do Ignite UI
Se você estiver criando um novo aplicativo Angular do zero, recomendamos usar a abordagem descrita abaixo, pois ela fornecerá uma experiência guiada amigável. O guia o guiará por todas as opções de configuração e seu projeto será estruturado em um piscar de olhos.
Para começar, instale Ignite UI CLI globalmente:
npm install -g igniteui-cli
Se você estiver usando o yarn
gerenciador de pacotes:
yarn global add igniteui-cli
Using guided experience
A maneira mais curta e fácil de inicializar um aplicativo é usar o guia passo a passo usando Ignite UI CLI.
Para ativar o guia usando a CLI do Ignite UI, execute:
ig
ou
ig new
Create a new project
Ao usar Ignite UI CLI, você precisa fornecer angular
como estrutura e igx-ts
como argumento de tipo de projeto para o new
comando:
ig new newAngularProject --framework=angular --type=igx-ts --template=side-nav
Note
A partir de v13.1.0
, o igx-ts
tipo de projeto gerará um projeto que usa componentes independentes por padrão. Se você preferir usar o bootstrapping baseado em módulo, você pode definir o type
como ser igx-ts-legacy
.
O novo aplicativo é criado em um diretório com o mesmo nome (newAngularProject
). Existem vários modelos de projeto que você pode escolher ao criar um aplicativo Ignite UI for Angular:
ID do modelo | Descrição do modelo |
---|---|
vazio | Estrutura do projeto com roteamento e uma página inicial |
navegação lateral | Estrutura do projeto com gaveta de navegação lateral |
autenticação de navegação lateral | Projeto de navegação lateral estendido com módulo de autenticação de usuário. Angular tópico Modelo de Projeto de Autenticação aborda o modelo de projeto em detalhes. |
Além disso, você pode especificar argumentos para controlar o tema ou ignorar a instalação de pacotes:
nome
name
(alias:-n
)
O nome do aplicativo. O aplicativo é criado dentro de um diretório com o mesmo nome.
framework(Ignite UI CLI apenas)
--framework
(alias:-f
) Valor padrão: "jQuery"
Framework para configurar o projeto. As estruturas suportadas são jQuery, Angular e React.
type( somente Ignite UI CLI)
--type
(alias:-t
)
Os tipos de projeto disponíveis dependem da estrutura selecionada.
tema
--theme
(alias:-th
)
Tema do projeto (depende do tipo de projeto).
pular-git
--skip-git
(alias:--sg
)
Quando esta opção for usada, a inicialização automática do repositório com o Git será ignorada. Se a opção for omitida, a propriedade de configuração global skip-git será usada.
pular-instalar
--skip-install
(alias:--si
)
O new
comando instalará as dependências do pacote na criação do projeto. Passar esse sinalizador ignorará a instalação inicial.
modelo
--template
Use essa opção se houver modelos de projeto diferentes para um tipo de estrutura específico. Atualmente, esta opção está disponível apenas para Ignite UI for Angular tipos de projeto igx-ts.
Add template
Para adicionar um dos modelos de Ignite UI Angular disponíveis, você precisa fornecer a ID do modelo e um nome para o novo componente ou usar o Guia passo a passo. Seu uso é suportado apenas dentro de projetos existentes criados com a CLI Ignite UI, Angular Schematics ou onde Ignite UI for Angular foi instalado usando ng add
.
Usamos o ig add [template] [name]
comando:
ig add grid newGrid
Para obter uma lista de todos os modelos disponíveis, você também pode executar o comando no diretório do ig list
seu projeto.
Além disso, você pode especificar o módulo no qual o componente será registrado ou ignorar a geração automática da rota de navegação do aplicativo:
módulo
--module
(alias:-m
)
Nota: O argumento module é aplicável somente em projetos Angular.
Caminho para o arquivo module.ts, relativo à pasta /src/app/, para o módulo onde o novo componente deve ser registrado:
ig add combo newCombo --module=myModule/myModule.module.ts
Pular rota
--skip-route
(alias:-srk
)
Não gere automaticamente uma rota de navegação do aplicativo para o novo componente
Run the application
O start
comando irá construir o aplicativo, iniciar um servidor web e abri-lo em seu navegador padrão:
ig start
Ignite UI CLI Commands
Uma lista completa dos comandos Ignite UI CLI disponíveis e seu uso (como passar sinalizadores, etc.), pode ser encontrada nas páginas wiki da CLI Ignite UI:
Comando | Cognome | Descrição |
---|---|---|
início do jogo | Compila o aplicativo, inicia um servidor Web e abre o aplicativo no navegador padrão. | |
construção do ig | Compila o aplicativo em um diretório de saída | |
ig gerar | g | Gera um novo modelo personalizado para estruturas e tipos de projeto com suporte |
ajuda do ig | -h | Lista os comandos disponíveis e fornece uma breve descrição do que eles fazem. |
configuração do ig | Executa a operação de leitura e gravação nas definições de configuração da CLI do Ignite UI. | |
ig doc | Pesquisa a base de dados de conhecimento Infragistics para obter informações sobre um determinado termo de pesquisa | |
lista ig | l | Lista todos os modelos para a estrutura e o tipo especificados. Quando você executa o comando em uma pasta de projeto, ele listará todos os modelos para a estrutura e o tipo do projeto, mesmo que você forneça modelos diferentes. |
Teste de IG | Executa os testes para o projeto atual. | |
versão ig | -v | Mostra Ignite UI versão da CLI instalada localmente ou globalmente se o local estiver ausente |