Bibliothèque de composants à Roku | Au nouveau blog

Qu’est-ce qu’une bibliothèque de composants

• Une bibliothèque de composants de Roku est une collection réutilisable de composants prédéfinis que les développeurs peuvent utiliser sur plusieurs canaux Roku.
• Ces composants encapsulent des fonctionnalités, des conceptions ou des éléments d’interface utilisateur spécifiques, ce qui permet d’économiser du temps et des efforts dans le processus de développement.
• La bibliothèque est hébergée sur un serveur et peut être facilement accessible et intégrée dans les canaux Roku via un fichier manifeste ou une configuration de dépendances.
• C’est un outil vital pour les développeurs de construire efficacement et efficacement les canaux Roku de haute qualité.

Avantages de l’utilisation d’une bibliothèque de composants

Une bibliothèque de composants offre plusieurs avantages qui rationalisent le processus de développement Roku et améliorent la qualité des canaux. Vous trouverez ci-dessous les principaux avantages:

• • Les composants sont prédéfinis et réutilisables, réduisant la nécessité d’écrire le même code à plusieurs reprises pour différents canaux Roku.
  • Gave le temps et les efforts, en particulier pour les éléments fréquemment utilisés comme les boutons, les menus ou les interfaces de joueur.
  • Si vous êtes offert par la bibliothèque, vous pouvez personnaliser l’apparence et la sensation des éléments d’interface utilisateur utilisés dans la bibliothèque.
  • Les développeurs peuvent rapidement intégrer des composants prêts à l’emploi dans leurs projets.
  • Raccourcit le cycle de développement, permettant aux équipes de se concentrer sur d’autres fonctionnalités.
  • Les mises à jour ou les corrections de bogues dans la bibliothèque se propagent automatiquement à tous les canaux à l’aide.
  • Simplifie le processus de maintien de plusieurs projets en centralisant la gestion des composants.
  • Économise des ressources, ce qui rend le processus de développement plus rentable.

Inconvénients de l’utilisation d’une bibliothèque de composants

Bien qu’une bibliothèque de composants offre de nombreux avantages, il est également livré avec certains inconvénients potentiels que les développeurs devraient considérer:

• • La construction d’une bibliothèque de composants robuste nécessite beaucoup de temps et d’efforts à l’avance.
  • Il implique une documentation appropriée (qui, bien sûr, prend du temps) avant de pouvoir être utilisées.
  • Les développeurs doivent comprendre comment intégrer et configurer correctement les composants.
  • Les canaux qui reposent sur une bibliothèque externe peuvent être confrontés à des problèmes si la bibliothèque n’est pas disponible ou non entretenue ou confrontée à certains problèmes techniques.
  • Les mises à jour de la bibliothèque pourraient rompre la compatibilité avec les canaux existants, nécessitant des retouches.
  • Les grandes bibliothèques peuvent inclure des composants inutilisés, l’augmentation de la taille de l’application inutilement.
  • Les développeurs n’ont pas l’accès au code source des bibliothèques.

Création de votre propre bibliothèque de composants

La création d’une bibliothèque de composants personnalisée pour les canaux Roku implique plusieurs étapes. Voici une approche claire pour construire votre propre bibliothèque:

• • Manifeste: Le fichier manifeste d’une bibliothèque de composants doit inclure les entrées suivantes:
    • • • • rsg_version drapeau
          • sg_component_libs_provided drapeau
          • caché drapeau
  • Structure la bibliothèque: Créez une structure de répertoire bien organisée pour la bibliothèque.
    • • • • Laissez le fichier main.brs vide. Assurez-vous qu’il ne contient aucun code.
          • Assurez-vous que le dossier des composants contient uniquement les composants réutilisables.
          • Assurez-vous que chaque composant est autonome avec des propriétés personnalisables, telles que les couleurs, les tailles ou les événements.

Structure de bibliothèque

• • Documentation :
    • • Fournir une documentation claire sur la façon d’utiliser chaque composant.
      • Incluez les extraits de code, les entrées attendues et le comportement de sortie.
      • Expliquez comment intégrer les composants dans les canaux Roku
  • Conditionnement: Les bibliothèques de composants peuvent être emballées et signées de la même manière que les applications sont emballées et signées. Vous chargez votre bibliothèque latérale, le package à l’aide de l’outil d’emballage, puis hébergez le fichier de package sur le serveur de votre choix. Vous obtiendrez un lien qui peut être partagé comme lien téléchargeable de la bibliothèque.

Conditionnement

• • Héberger la bibliothèque :
    • • Hébergez la bibliothèque sur un serveur ou une plate-forme cloud à version contrôlée pour un accès facile.
      • Options d’hébergement gratuites: GitHub, GitLab, Bitbucket, AWS S3.
      • Assurez-vous que la plate-forme d’hébergement prend en charge une intégration facile à l’aide des URL.

Utilisation d’une bibliothèque de composants dans un canal Roku

Nous devons comprendre le Composant Library Classe de nœud d’abord pour comprendre comment nous pouvons utiliser des bibliothèques hébergées dans nos canaux Roku. Le ComponentLibrary est un nœud Roku natif qui télécharge une bibliothèque de composants SceneGraph personnalisés à utiliser dans une application. Veuillez noter que le nœud ComponentLibrary doit être utilisé dans un Scène nœud, comme la scène ou Surplombant. Ceci est fait pour s’assurer que la bibliothèque est disponible avant d’être utilisée n’importe où dans l’application. ComponentLibrary n’a que trois champs qui sont les suivants:

• • chargeur: Il indique les progrès de la bibliothèque téléchargée. Les valeurs possibles de ce champ sont – aucune, le chargement, prêt, l’échec.
  • identifiant: C’est un identifiant unique pour la bibliothèque qui sera utilisé dans l’application. Cela peut être récupéré à partir de la documentation.
  • uri : C’est l’URL de la bibliothèque à télécharger. Nous passons l’URL de la bibliothèque hébergée dans ce domaine.

Maintenant que nous avons compris quelle est la classe de nœud ComponentLibrary, comprenons comment les étapes suivantes sont nécessaires pour utiliser une bibliothèque de composants hébergée dans d’autres canaux Roku:

• • Télécharger la bibliothèque des composants dans la scène

Bibliothèque de téléchargement

• • Incluez les composants déclarés dans une bibliothèque de composants à l’intérieur de votre application (Dans le fichier XML de n’importe quel composant) De la même manière que vous en incluez d’autres comme les composants personnalisés / natifs. Assurez-vous de le spécifier dans le format LibraryName: ComponentName. Alors disons si un composant nommé Progress-dialog est défini dans le SampleComponentLib bibliothèque, alors il peut être utilisé comme ceci:

Y compris la bibliothèque

• • Accédez à l’élément de composant dans le fichier BRS à l’aide de l’ID donné et fournissez-le les attributs requis.

Utilisation de la bibliothèque

Références:

• • https://developer.roku.com/docs/references/scenegraph/control-nodes/componentlibrary.md
  • https://github.com/rokucommunity/sample-projects/tree/master/component-library-and-project