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ê está usandoyarn o 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
When using Ignite UI CLI you need to provide angular as framework and igx-ts as your project type argument to the new command:
ig new newAngularProject --framework=angular --type=igx-ts --template=side-nav
Observação
As of v13.1.0, the igx-ts project type will generate a project that uses standalone components by default. If you prefer to use the module-based bootstrapping instead you can set the type to be igx-ts-legacy.
A nova aplicação é criada em um diretório com o mesmo nome (newAngularProject). Existem vários modelos de projeto entre os quais 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(pseudônimo:-n)
O nome do aplicativo. O aplicativo é criado dentro de um diretório com o mesmo nome.
framework(Ignite UI CLI apenas)
--framework(pseudônimo:-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(pseudônimo:-t)
Os tipos de projeto disponíveis dependem da estrutura selecionada.
tema
--theme(pseudônimo:-th)
Tema do projeto (depende do tipo de projeto).
pular-git
--skip-git(pseudônimo:--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(pseudônimo:--si)
Onew comando instalará dependências de pacotes na criação do projeto. Passar por essa bandeira pula 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
To add one of the available Ignite UI Angular templates you need to provide template ID and a name for the new component or use the Step-by-Step Guide. Their usage is supported only inside existing projects created with the Ignite UI CLI, Angular Schematics or where Ignite UI for Angular has been installed using ng add.
We use the ig add [template] [name] command:
ig add grid newGrid
To get a list of all the available templates you can also execute the ig list command in your project directory.
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(pseudônimo:-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(pseudônimo:-srk)
Não gere automaticamente uma rota de navegação do aplicativo para o novo componente
Run the application
The start command will build the application, start a web server and open it in your default browser:
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 |