Perguntas frequentes sobre licença e instalação
Ignite UI for Angular é oferecido sob um modelo de licença dupla, que permite tanto o uso comercial quanto o permissivo de código aberto, dependendo dos componentes, módulos, diretivas e serviços utilizados.
É fundamental entender qual licença se aplica a qual parte do pacote. O tópico Open Source vs Premium contém detalhes sobre que tipo de licença é aplicada a cada componente e, portanto, se você precisa comprar uma licença comercial com base nos componentes que está usando em seus projetos.
License Agreements
Para componentes sob licença comercial, é importante conhecer todos os termos e condições legais que se aplicam à sua compra e uso.
Note
Atualizamos nossos termos de licença e o modelo de assinatura no quarto trimestre de 2025.
Se seu teste terminou ou sua assinatura expirou, cada desenvolvedor da sua equipe que usar componentes sob licença comercial de Ignite UI precisará adquirir uma assinatura. Isso permitirá que você use nosso feed privado npm hospedado no https://packages.infragistics.com/npm/js-licensed/ para desenvolvimento. Lá você encontrará as versões mais recentes dos pacotes Ignite UI for Angular. Se você tem uma assinatura atual, pode usar este feed privado e terá acesso à versão completa do Ignite UI for Angular.
Infragistics oferece licenças gratuitas, não comerciais e não destinadas à revenda (NFR) para o seguinte:
- Se você faz parte de um programa de desenvolvedor como o Microsoft MVP, o Microsoft Regional Director, o Google Developer Expert, etc.
- Se você é um estudante primário, secundário ou universitário, ou uma instituição acadêmica, ou um professor.
Se você se qualificar para uma licença NFR gratuita e não comercial ou se tiver alguma dúvida sobre a licença, entre em contato conosco.
Ignite UI for Angular npm packages - Using the Private npm feed
O Npm é o gerenciador de pacotes mais popular e também é o padrão para o ambiente de tempo de execução Node.js. Altamente adotado, é uma das maneiras mais rápidas e fáceis de gerenciar os pacotes dos quais você depende em seu projeto. Para obter mais informações sobre como o npm funciona, leia a documentação oficial do npm.
Infragistics Ignite UI for Angular está disponível como um pacote npm e você pode adicioná-lo como uma dependência ao seu projeto emfew easy steps using the Ignite UI CLI um ou usando Ignite UI for Angular Schematics. Escolher essa abordagem não exigirá configurar o npm. Se você planeja usar componentes de Ignite UI for Angular sob licença do MIT, não há mais nada que precise fazer. No entanto, se você estiver usando componentes sob uma licença comercial, baixar o pacote do npm inicia o período de teste do produto.
Note
O que significa começar a usar uma versão de teste? Isso significa que você usará uma versão do nosso produto com uma parte de marca d'água da sua visualização da web. Isso não significa que você usará o pacote licenciado por um determinado período de tempo antes de expirar. Por exemplo, por um mês.
O Infragistics Ignite UI Dock Manager Web Component está disponível como um pacote npm separado e, ao instalá-lo, você começará a usar a versão de teste do Ignite UI Dock Manager Web Component do produto.
Mais informações sobre como começar a usar o pacote Ignite UI for Angular npm podem ser encontradas neste tópico. Informações adicionais sobre Ignite UI Dock Manager Web Component podem ser encontradas na documentação do Dock Manager.
Upgrading packages using our Angular Schematics or Ignite UI CLI
Se Ignite UI for Angular foi adicionado ao projeto usandong add ou se o projeto foi criado por meio de nossa coleção de esquemas ou Ignite UI CLI, você pode usar ouupgrade-packages para atualizar automaticamente seu aplicativo para usar nossos pacotes licenciados. As dependências do seu pacote de projeto incluirão um ou@igniteui/angular-schematics outroigniteui-cli, com ambos suportando o comando upgrade.
Note
Como o processo altera os pacotes, recomendamos que você atualize seu projeto antes de alternar. Dessa forma, você evitará pegar uma versão superior do Ignite UI Angular e perder possíveis migrações de atualização. Siga nosso Guia de atualização.
Dependendo da configuração do projeto, execute o seguinte esquema em seu projeto:
ng g @igniteui/angular-schematics:upgrade-packages
ou usarigniteui-cli:
ig upgrade-packages
O esquema ou comando se encarregará de alternar as dependências do pacote do projeto e atualizar as referências de origem. Você será solicitado a fazer login em nosso registro npm, caso ainda não esteja configurado.
Note
Se seu projeto está usandoyarn, certifique-se de usarupgrade-packages a--skip-install bandeira. Depois, executeyarn install depois para atualizar corretamente comoyarn.lock o comando upgrade usanpm atualmente para a instalação.
How to setup your environment to use the private npm feed (Step by step guide)
Primeiro, você precisa configurar o registro privado e associá-lo ao escopo Infragistics
Isso permitirá que você use perfeitamente uma combinação de pacotes do registro npm público e do registro privado Infragistics.
Note
Se sua conta não estiver licenciada (você ainda estiver usando uma conta de avaliação), o feed de pacotes privado não estará acessível para você, por exemplo, ele retornará a mensagem de erro 404 ou 403. Somente contas licenciadas podem acessar o feed privado packages.infragistics.
Now, to log in to our private feed using npm
npm versão 9+
Nosso feed privado atualmente não suportalogin/adduser comandos com npm v9, então recomendamos os seguintes passos para adicionar os campos de autenticação necessários à configuração:
npm config set @infragistics:registry https://packages.infragistics.com/npm/js-licensed/
npm config set //packages.infragistics.com/npm/js-licensed/:username=YOUR_USERNAME
npm config set //packages.infragistics.com/npm/js-licensed/:email=YOUR_IG_EMAIL
npm config set //packages.infragistics.com/npm/js-licensed/:_auth=YOUR_IG_AUTH_TOKEN
Você pode gerar o Access Token por meio do seu perfil Infragistics.
Essa abordagem é aplicável a todas as versões anteriores denpm.
Versão npm até v8
Execute oadduser comando e especifique uma conta de usuário e senha:
npm adduser --registry=https://packages.infragistics.com/npm/js-licensed/ --scope=@infragistics
Você será solicitado a fornecer o nome de usuário e a senha que você usa para fazer login em sua conta Infragistics. Você também deve fornecer o e-mail registrado em seu perfil Infragistics.
Note
npmé proibir o uso do"@" símbolo dentro do seu nome de usuário, pois é considerado "não seguro para a internet". Como seu nome de usuário é na verdade o e-mail que você usa para sua conta Infragistics, ele sempre contém o símbolo"@". Por isso, você deve escapar dessa limitação substituindo o"@" símbolo por"!!" (dois pontos de exclamação). Por exemplo, se seu nome de usuário estiver"username@example.com" quando perguntado sobre seu nome de usuário, você deve fornecer a seguinte entrada:"username!!example.com"
Note
Comportamento do shell do macOS: Se você está usando macOS e configurando o:_auth token manualmente,npm config set certifique-se de enrolar o token entre aspas duplas assim:
npm config set //packages.infragistics.com/npm/js-licensed/:_auth="YOUR_IG_AUTH_TOKEN"
Isso é necessário devido às diferenças de análise de shell no macOS que podem causar problemas de autenticação se os caracteres especiais no token não forem citados corretamente. Esse problema normalmente não ocorre no Windows.
Depois disso, você estará logado e poderá instalar as versões mais recentes dos pacotes de Ignite UI no seu projeto
npm uninstall igniteui-angular
npm install @infragistics/igniteui-angular
npm uninstall igniteui-dockmanager
npm install @infragistics/igniteui-dockmanager
Lembre-se de que definimos o pacote Ignite UI for Angular para ser definido pelo escopo, o que significa que nenhuma alteração no registro é necessária se você quiser instalar pacotes do nosso feed privado e do npmjs.org simultaneamente.
Algumas alterações adicionais podem ter que ser feitas no código-fonte do projeto
Se você está atualizando de um pacote de teste para um licenciado e não está usando as migrações automáticas de CLI:
- Adicione um mapeamento de caminhos na tsconfig.json do projeto.
{
/* ... */
"compilerOptions": {
"baseUrl": "./",
"outDir": "./dist/out-tsc",
/* ... */
"paths": {
"igniteui-dockmanager": ["./node_modules/@infragistics/igniteui-dockmanager"],
"igniteui-dockmanager/*": ["./node_modules/@infragistics/igniteui-dockmanager/*"],
}
}
}
- Adicione um
stylePreprocessorOptionsmapeamento ao seu projetoangular.json
{
"projects": {
..
"prefix": "app",
"architect": {
"build": {
"builder": "@angular-devkit/build-angular:browser",
"options": {
...
"aot": true,
"stylePreprocessorOptions": {
"includePaths": [
"node_modules/@infragistics"
]
}
...
},
- Remova o
~sinal das importações Sass do seu projeto para aigniteui-angular/libfonte:
@use "~igniteui-angular/lib/core/styles/themes/index" as *;
// Should be changed to
@use "igniteui-angular/lib/core/styles/themes/index" as *;
Se você já adotou o npm e tem uma licença Ignite UI for Angular, configure o feed privado Infragistics para aumentar sua produtividade e aproveitar todo o potencial da Ignite UI for Angular.
Access Token Usage
Você também pode se autenticar em nosso feed npm privado usando um token de acesso, que pode ser adquirido por meio de sua conta de usuário infragistics.com. A autenticação de token de acesso é a alternativa preferencial quando você deseja integrar um processo de CI em um repositório acessível publicamente que usa os Ignite UI for Angular pacotes licenciados.
As informações a seguir são sobre como configurar a autenticação em nosso registro npm privado usando um token de acesso na configuração local, procedimentos de build do Azure Pipelines e processo de build do Travis CI:
- Gerar um token a partir do https://account.infragistics.com/package-feeds
Note
Cada token é codificado em Base64.
- Adicione o seguinte ao seu.npmrc file
@infragistics:registry=https://packages.infragistics.com/npm/js-licensed/
//packages.infragistics.com/npm/js-licensed/:_auth=YOUR_ACCESS_TOKEN
//packages.infragistics.com/npm/js-licensed/:username=YOUR_USERNAME
Azure Pipelines Configuration
Atualizeazure-pipelines.yml com os seguintes passos:
steps:
- script: npm config set @infragistics:registry $(npmRegistry)
displayName: 'Npm add registry'
- script: npm config set $(igScope):_auth=$(token)
displayName: 'Npm config auth'
Agora, adicione variáveis para o registro npm, escopo e token. Existem duas maneiras de fazer isso:
Defina Grupo de Variáveis a partir da página Biblioteca em Pipelines
Este artigo explica como usar um grupo de variáveis para armazenar valores que você deseja controlar e disponibilizar em vários pipelines.
Defina as variáveis na interface de Configurações do Pipeline e faça referência a elas no seu arquivo YAML
No caso mais comum, você define as variáveis e as usa no arquivo YAML.
Travis CI Configuration
Siga uma abordagem semelhante aqui. A única diferença é que a configuração é definida nobefore_install passo:
before_install:
- echo "@infragistics:registry=https://packages.infragistics.com/npm/js-licensed/" >> ~/.npmrc
- echo "//packages.infragistics.com/npm/js-licensed/:_auth=$TOKEN" >> ~/.npmrc
A melhor maneira de definir uma variável de ambiente depende do tipo de informação que ela conterá. Então você tem duas opções:
- criptografá-lo e adicioná-lo ao seu .travis.yml
- adicione-o às configurações do repositório
GitHub Actions Configuration
Adicione os seguintes scripts antes danpm install etapa (ounpm ci etapa) na configuração do seu fluxo de trabalho de CI:
- run: echo "@infragistics:registry=https://packages.infragistics.com/npm/js-licensed/" >> ~/.npmrc
- run: echo "//packages.infragistics.com/npm/js-licensed/:_auth=${{ secrets.NPM_TOKEN }}" >> ~/.npmrc
Defina segredos (variáveis de ambiente criptografadas) e use-os no fluxo de trabalho de ações do GitHub para informações confidenciais, como o token de acesso.
GitHub