Perguntas frequentes sobre licença e instalação

    License Agreements

    É importante conhecer todos os termos e condições legais relativos aos produtos que você compra e usa.

    Note

    Atualizamos nossos termos de licença e modelo de assinatura no segundo trimestre de 2020.

    Se sua avaliação tiver terminado ou sua assinatura tiver expirado, cada desenvolvedor da sua equipe que usa Ignite UI precisará comprar uma assinatura. Isso permitirá que você use nosso feed npm privado 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ê tiver uma assinatura atual, poderá usar este feed privado e terá acesso à versão completa do Ignite UI for Angular.

    Para obter uma explicação detalhada do contrato de licença Ignite UI e dos termos de uso, clique aqui.

    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 em um few easy steps using the Ignite UI CLI ou usando Ignite UI for Angular Schematics. A escolha dessa abordagem não exigirá a configuração do npm. Ao instalar este pacote, você começará a usar a versão de teste Ignite UI for Angular 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.

    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 avaliação Ignite UI do 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 aqui.

    Upgrading packages using our Angular Schematics or Ignite UI CLI

    Se Ignite UI for Angular tiver sido adicionado ao projeto usando ng add ou o projeto tiver sido criado por meio de nossa coleção de esquemas ou Ignite UI CLI, você poderá usar nosso upgrade-packages para atualizar automaticamente seu aplicativo para usar nossos pacotes licenciados. As dependências do pacote do projeto incluirão um ou @igniteui/angular-schematics​ ​igniteui-cli mais, 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 usar igniteui-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 o seu projeto estiver usando yarn, certifique-se de executar upgrade-packages com o--skip-install sinalizador. Em seguida, execute yarn install depois para atualizar corretamente o seu yarn.lock como o comando de atualização usa npm 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 oferece suporte a comandos login/adduser com npm v9, portanto, recomendamos as seguintes etapas 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 do npm.

    Versão npm até v8

    Execute o adduser 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 is disallowing the use of the "@" symbol inside your username as it is considered as being "not safe for the net". Because your username is actually the email that you use for your Infragistics account it always contains the symbol "@". That's why you must escape this limitation by replacing the "@" symbol with "!!" (two exclamation marks). For example, if your username is "username@example.com" when asked about your username you should provide the following input: "username!!example.com".

    Depois que isso for feito, você estará logado e poderá instalar as versões mais recentes dos pacotes Ignite UI em 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, o que significa que não é necessário alterar os registros se você quiser instalar pacotes de nosso feed privado e de npmjs.org simultaneamente.

    Algumas alterações adicionais podem ter que ser feitas no código-fonte do projeto

    Se você estiver atualizando do pacote de avaliação para o licenciado e não estiver usando as migrações automatizadas da CLI:

    • Adicione um mapeamento de caminhos no 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/*"],
    }
  }
}
    • Adicionar um stylePreprocessorOptions mapeamento ao seu projeto angular.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 do seu projeto sass para igniteui-angular/lib Source:
    @use "~igniteui-angular/lib/core/styles/themes/index" as *;

// Should be changed to
@use "igniteui-angular/lib/core/styles/themes/index" as *;

    Portanto, se você já adotou o npm e possui uma licença Ignite UI for Angular, não hesite em configurar o feed privado Infragistics e aumentar sua produtividade, usando todo o potencial do 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:

    Novo token gerado

    Note

    Cada token está com codificação Base64.

    @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

    Atualize o azure-pipelines.yml com as seguintes etapas:

    steps:

- script: npm config set @infragistics:registry $(npmRegistry)
  displayName: 'Npm add registry'
- script: npm config set $(igScope):_auth=$(token)
  displayName: 'Npm config auth'

    Agora precisamos adicionar variáveis para o registro, escopo e token​ ​npm. Existem duas maneiras de fazer isso:

    Defina o Grupo de Variáveis na 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.

    Definir variáveis de token e registro npm

    Defina as variáveis na interface do usuário de configurações de pipeline e faça referência a elas em seu arquivo YAML.

    No caso mais comum, você define as variáveis e as usa no arquivo YAML.

    Definir variáveis de token e registro npm

    Registro npm e variáveis de token

    Travis CI Configuration

    Seguiremos quase a mesma abordagem aqui. A única diferença seria que a configuração será definida em before_install

    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:

    GitHub Actions Configuration

    Adicione os seguintes scripts antes da etapa à configuração do npm i(ci)​ ​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.