Perguntas frequentes sobre licença e instalação

    Ignite UI for React compreende pacotes disponíveis sob licença do MIT ou comercial. Esse modelo de licenciamento suporta tanto o uso comercial quanto o permissivo de código aberto, dependendo dos componentes, módulos e serviços específicos que você incorpora ao seu projeto.

    É 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 in Ignite UI for React

    Para componentes sob licença comercial, é importante conhecer todos os termos e condições legais relacionados à sua compra e uso.

    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 React. Se você tem uma assinatura atual, pode usar este feed privado e terá acesso à versão completa do Ignite UI for React.

    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 React 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 e é 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 React está disponível como pacotes npm e você pode adicioná-los como dependências ao seu projeto em alguns passos simples. Escolher essa abordagem não exigirá configurar o npm. Se você estiver instalando um pacote sob licença comercial, começará a usar a versão de teste Ignite UI for React do produto.

    [!NOTE] What does it mean to start using a trial version? It means that you will be using a version of our product with a Watermark part of your web view. It doesn’t mean that you will be using the licensed package for a certain amount of time before it expires. For example, for a month.

    O feed privado de npm Infragistics fornece contém versões licenciadas dos pacotes sob licença comercial.

    How to setup your environment to use the private npm feed

    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. 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 no seu perfil Infragistics.

    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 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.

    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"

    Depois disso, você estará logado e poderá instalar as versões mais recentes dos pacotes de Ignite UI no seu projeto

    npm uninstall igniteui-react-dockmanager
    npm install @infragistics/igniteui-react-dockmanager
    
    npm uninstall igniteui-react-dockmanager
    npm install @infragistics/igniteui-react-dockmanager
    

    Lembre-se de que definimos o pacote Ignite UI for React 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.

    Changes in your project source after license package update

    Se você estiver atualizando do pacote de teste para o licenciado, os novos pacotes serão incluídos no escopo@infragistics. Como resultado, você pode:

    • Faça uma substituição global para todos os pacotes de teste e mude para a versão licenciada com escopo em todos os arquivos do seu projeto. Por exemplo, substitua todasigniteui-react-dockmanager as referências a@infragistics/igniteui-react-dockmanager A mudança deve afetar todas as importações onde tais pacotes são usados.

      Ou

    • Adicione um mapeamento de caminhos no tsconfig.json do projeto.

    {
      /* ... */
      "compilerOptions": {
        "baseUrl": "./",
        "outDir": "./dist/out-tsc",
        /* ... */
        "paths": {
          "igniteui-react-dockmanager": ["./node_modules/@infragistics/igniteui-react-dockmanager"],
          "igniteui-react-dockmanager/*": ["./node_modules/@infragistics/igniteui-react-dockmanager/*"],
        }
      }
    }
    

    Aqui está um exemplo completo com todos os mapeamentos de caminho para os pacotes react que você pode precisar:

          "paths": {
            "igniteui-react-core": ["node_modules/igniteui-react-core", "node_modules/@infragistics/igniteui-react-core"],
            "igniteui-react-charts": ["node_modules/igniteui-react-charts", "node_modules/@infragistics/igniteui-react-charts"],
            "igniteui-react-dockmanager": ["node_modules/igniteui-react-dockmanager", "node_modules/@infragistics/igniteui-react-dockmanager"],
            "igniteui-react-grids": ["node_modules/igniteui-react-grids", "node_modules/@infragistics/igniteui-react-grids"],
            "igniteui-react-data-grids": ["node_modules/igniteui-react-data-grids", "node_modules/@infragistics/igniteui-react-data-grids"],
            "igniteui-react-grids/grids": ["node_modules/igniteui-react-grids/grids", "node_modules/@infragistics/igniteui-react-grids/grids"],
            "igniteui-react-gauges": ["node_modules/igniteui-react-gauges", "node_modules/@infragistics/igniteui-react-gauges"],
            "igniteui-react-inputs": ["node_modules/igniteui-react-inputs", "node_modules/@infragistics/igniteui-react-inputs"],
            "igniteui-react-layouts": ["node_modules/igniteui-react-layouts", "node_modules/@infragistics/igniteui-react-layouts"],
            "igniteui-react-maps": ["node_modules/igniteui-react-maps", "node_modules/@infragistics/igniteui-react-maps"],
            "igniteui-react": ["node_modules/igniteui-react", "node_modules/@infragistics/igniteui-react"],
            "igniteui-react-excel": ["node_modules/igniteui-react-excel", "node_modules/@infragistics/igniteui-react-excel"],
            "igniteui-react-datasources": ["node_modules/igniteui-react-datasources", "node_modules/@infragistics/igniteui-react-datasources"],
            "igniteui-react-spreadsheet": ["node_modules/igniteui-react-spreadsheet", "node_modules/@infragistics/igniteui-react-spreadsheet"],
            "igniteui-react-spreadsheet-chart-adapter": ["node_modules/igniteui-react-spreadsheet-chart-adapter", "node_modules/@infragistics/igniteui-react-spreadsheet-chart-adapter"],
            "igniteui-webcomponents": ["node_modules/igniteui-webcomponents", "node_modules/@infragistics/igniteui-webcomponents"]
          }
    
    • Altere as importações de temas assim:
    @import '~igniteui-react-dockmanager/dist/collection/styles/igc.themes';
    
    // Should be changed to
    
    @import '~@infragistics/igniteui-react-dockmanager/dist/collection/styles/igc.themes';
    

    Portanto, se você já adotou o npm e possui uma licença Ignite UI for React, não hesite em configurar o feed privado Infragistics e aumentar sua produtividade, usando todo o potencial do Ignite UI for React.

    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 React 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

    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'
    

    Adicione variáveis de registro e token npm.

    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 do passo **npm i(ci)* - à 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 sensíveis como o token de acesso.