Présentation des clés de licence à KendoReact

Avec la sortie officielle de KendoReact 4.0 aujourd'hui le 22 octobre, nous annonçons un nouveau changement en cours dans KendoReact: l'introduction des clés de licence.

Qu'est-ce qui change?

Avec KendoReact 4.0 , nous ajoutons une exigence pour entrer une clé de licence lors de l'ajout d'un package KendoReact npm à vos applications. Il existe deux façons d'obtenir une clé de licence: en vous inscrivant pour un essai gratuit ou en achetant une licence.

Chaque fois qu'un KendoReact package npm (v4.0 +) est ajouté à un projet React, les développeurs verra un message d'avertissement dans la console développeur du navigateur indiquant qu'une clé de licence est requise. Ce message mènera directement à la page Ma licence avec des instructions sur la façon d'acquérir et d'installer la licence, ce qui supprimera l'avertissement de la console développeur.

L'accès à votre clé de licence est transparent et activé c'est aussi simple que d'exécuter une seule commande dans votre CLI. Nous verrons à quoi cela ressemble dans la section «Comment utiliser votre clé de licence» ci-dessous.

Pourquoi les clés de licence?

KendoReact sert ses packages via npm pour rendre facile et intuitif pour les développeurs React d'ajouter KendoReact à tout projet. Nous reconnaissons que npm est la norme pour l'ajout de packages dans des applications Web modernes. Une limitation de cette configuration est qu'une bibliothèque commerciale telle que KendoReact ne dispose d'aucun outil pour assister les essais ou les utilisateurs licenciés.

Afin de continuer à offrir KendoReact sur npm et de soutenir nos efforts de développement et nos plans ambitieux à long terme pour la bibliothèque, nous sommes arrivés à la conclusion que l'ajout de clés de licence donnera à l'équipe un moyen de gérer l'utilisation d'essai et de licence tout en étant en grande partie sans tracas pour nos utilisateurs.

Cela m'affecte-t-il aujourd'hui?

Cela affectera tout utilisateur qui travaille avec KendoReact 4.0 et au-delà. Donc, si vous avez déjà KendoReact dans vos projets, vous ne verrez ce message que lorsque vous passerez à la version 4.0.

En fin de compte, ce sera quelque chose qui affectera tous les utilisateurs de KendoReact, qu'ils soient un utilisateur d'essai ou un développeur sous licence

Comment utiliser ma clé de licence

Si vous n'emportez avec vous qu'une seule chose de ce billet de blog, cela devrait être la page Configurer votre clé de licence KendoReact . Cette page contient tous les détails sur le fonctionnement de cette nouvelle configuration. Plus précisément, il couvre:

• Comment accéder à votre clé de licence
• Comment installer ou mettre à jour la clé de licence dans vos projets
• Comment enregistrer la clé de licence

Comment accéder à ma clé de licence

La page d'information susmentionnée contient une section «Télécharger votre clé de licence». Connectez-vous avec votre compte Telerik et recherchez le bouton intitulé kendo-ui-license.txt que vous devez télécharger. Vous avez besoin d'une version d'évaluation ou d'une licence de développeur KendoReact active pour obtenir une clé de licence.

Installer ou mettre à jour ma clé de licence

Que ce soit la première fois que vous démarrez une version d'évaluation de KendoReact, vous cherchez à passer d'une licence d'évaluation à une licence développeur, ou vous êtes un développeur sous licence mettant à jour vers KendoReact 4.0, le processus est le même.

1. Copiez le fichier de clé de licence ( kendo-ui-license.txt ) dans le dossier racine de votre projet.
2. Installez @ progress / kendo-licensing en tant que dépendance de projet en exécutant npm install --save @ progress / kendo-licensing .
3. Exécutez npx kendo-ui-license activate dans la console.
4. Ajoutez le fichier de licence au contrôle de code source pour activer l'activation automatique, par exemple dans les versions automatisées.

Et c’est vraiment tout! Cela devrait être aussi simple que d'exécuter une seule commande, et une fois que le fichier de licence est opérationnel, vous pouvez l'utiliser dans les environnements de développement, de préparation et de production.

Si vous êtes un utilisateur d'essai qui a déjà ajouté une clé de licence puis acheté une licence, vous devrez télécharger une nouvelle clé de licence après votre achat sur la page Ma licence et suivre les mêmes instructions pour associer votre licence de développeur à votre implémentation KendoReact.

Si vous êtes un client renouvelant qui a utilisé une clé de licence précédemment, puis mis à jour vos packages KendoReact, vous pouvez voir un message indiquant que le package ne fait pas partie de votre licence. Si tel est le cas, vous devez simplement obtenir une nouvelle clé de licence (associée à votre achat de renouvellement) et ajouter la clé de licence en suivant les mêmes instructions.

KendoReact License Keys in Practice

Avec toutes les informations ci-dessus. Voyons à quoi tout cela ressemble en ajoutant un composant à une nouvelle application React.

Donc, dans mon cas, j'ai une nouvelle application React construite avec create-react-app . J'ai sélectionné au hasard un composant KendoReact (en utilisant la méthode infaillible de cliquer au hasard sur la page du composant) et j'ai décidé d'ajouter le composant KendoReact DropDownList.

En suivant les instructions sur la documentation de présentation du paquet DropDown J'exécuterai la commande suivante npm install :

npm install --save @ progress / kendo-react-dropdowns @ progress / kendo-react-intl

Pendant ce temps peut bien sûr faire partie de la commande ci-dessus J'ai séparé ceci pour m'assurer de pouvoir mettre en évidence ce nouveau paquet que nous devons tous installer:

npm install --save @ progress / kendo-licensing

C'est le paquet qui est responsable de l'activation de notre clé de licence et tout paquet KendoReact nécessite l'inclusion de @ progress / kendo-licensing en tant que dépendance.

Une fois que j'ai ajouté le composant DropDownList dans mon fichier App.js comme indiqué sur ] la page de démarrage de DropDownList et exécutez l'application que nous verrons dans la console:

Le message nous indique que nous devons appliquer une clé de licence. De façon pratique, nous avons un lien dans le message qui nous mène à la page de licence de KendoReact . De là, je peux suivre les instructions que j'ai mentionnées ci-dessus dans cet article, ou sur la page des licences, et télécharger mon fichier de licence en trouvant ce bouton sur la page (notez que vous devez être connecté à un compte Telerik pour voir cela) :

Maintenant que j'ai téléchargé le fichier de licence, je vais ajouter kendo-ui-license.txt à la racine de mon projet.

Une fois que cela a été ajouté au projet, j'ai juste une commande rapide à exécuter:

npx kendo-ui-license activate

Et ça devrait être ça! La prochaine fois que j'exécuterai mon projet, le message d'avertissement devrait disparaître et nous serons en route pour les courses. C'est vraiment aussi simple que ça.

Questions supplémentaires

Si vous avez une question non répondu dans ce blog, veuillez consulter la section Foire aux questions de la page Configurer votre clé de licence KendoReact qui c sur plus de scénarios. Vous pouvez également toujours compter sur notre équipe d'assistance pour des questions supplémentaires sur ce changement.

Vous avez des commentaires?

Y at-il des moyens d'améliorer ce mécanisme de licence pour vous et votre équipe? Qu'il s'agisse de nouveaux composants, fonctionnalités ou quelque chose dans toute la bibliothèque, comme les clés de licence, nous voulons nous assurer que nous vous entendons. Vous pouvez laisser un commentaire dans la section ci-dessous ou soumettre un ticket d'assistance pour discuter directement avec notre équipe d'assistance et d'ingénierie concernant tous les commentaires et commentaires que vous pourriez avoir à propos de cet effort!