NativeScript - Modules

Un module NativeScript contient un ensemble de fonctionnalités associées regroupées sous forme de bibliothèque unique. Apprenons les modules fournis par le framework NativeScript.

Il contient les fonctionnalités de base du framework NativeScript. Laissez-nous comprendre les modules de base de ce chapitre.

Application

L'application contient une mise en œuvre spécifique à la plate-forme de l'application mobile. Le module de base simple est défini ci-dessous -

const applicationModule = require("tns-core-modules/application");

Console

Le module de console est utilisé pour enregistrer le message. Il a les méthodes suivantes -

console.log("My FirstApp project"); 
console.info("Native apps!"); 
console.warn("Warning message!"); 
console.error("Exception occurred");

paramètres de l'application

Le module de paramètres d'application contient une méthode pour gérer les paramètres d'application. Pour ajouter ce module, nous devons ajouter le code suivant -

const appSettings = require("tns-core-modules/application-settings");

Quelques méthodes disponibles dans les paramètres d'application sont les suivantes -

  • setBoolean (key: string, value: boolean) - définir un objet booléen

  • setNumber (key: string, value: number) - objet set number

  • setString (key: string, value: string) - définit l'objet string

  • getAllKeys () - Contient toutes les clés stockées

  • hasKey (key: string) - vérifier si une clé est présente ou non

  • clear - efface les valeurs stockées

  • remove - supprime toute entrée basée sur la clé.

Voici un exemple simple d'utilisation du paramètre d'application:

function onNavigatingTo(args) { 
   appSettings.setBoolean("isTurnedOff", false);
   appSettings.setString("name", "nativescript"); 
   appSettings.setNumber("locationX", 54.321); 
   const isTurnedOn = appSettings.getBoolean("isTurnedOn"); 
   const username = appSettings.getString("username"); 
   const locationX = appSettings.getNumber("locationX"); 
   // Will return "not present" if there is no value for "noKey" 
   const someKey = appSettings.getString("noKey", "not present"); 
}
exports.onNavigatingTo = onNavigatingTo; 
function onClear() {
   // Removing a single entry via its key name 
   appSettings.remove("isTurnedOff"); 
   // Clearing the whole settings 
   appSettings.clear(); 
}

http

Ce module est utilisé pour la manipulation httpdemande et réponse. Pour ajouter ce module dans votre application, ajoutez le code suivant -

const httpModule = require("tns-core-modules/http");

Nous pouvons envoyer des données en utilisant les méthodes suivantes -

getString- Il est utilisé pour faire une demande et télécharge les données de l'URL sous forme de chaîne. Il est défini ci-dessous -

httpModule.getString("https://.../get").then(
   (r) => { 
      viewModel.set("getStringResult", r); 
   }, (e) => 
   { 
   }
);

getJSON- Il est utilisé pour accéder aux données de JSON. Il est défini ci-dessous -

httpModule.getJSON("https://.../get").then((r) => { 
}, (e) => { 
});

getImage- télécharge le contenu à partir de l'URL spécifiée et renvoie l'objet ImageSource. Il est défini ci-dessous -

httpModule.getImage("https://.../image/jpeg").then((r) => { 
}, (e) => { 
});

getFile - Il a deux arguments URL et chemin de fichier.

  • URL - télécharge les données.

  • File path- enregistrer les données URL dans le fichier. Il est défini ci-dessous -

httpModule.getFile("https://").then((resultFile) => { 
}, (e) => { 
});

request- Il a un argument d'options. Il est utilisé pour demander des options et renvoyer l'objet HttpResponse. Il est défini ci-dessous -

httpModule.request({ 
   url: "https://.../get", 
   method: "GET" 
}).then((response) => { 
}, (e) => { 
});

Source de l'image

Le module image-source est utilisé pour enregistrer l'image. Nous pouvons ajouter ce module en utilisant la déclaration ci-dessous -

const imageSourceModule = require("tns-core-modules/image-source");

Si vous souhaitez charger des images à partir de la ressource, utilisez le code ci-dessous -

const imgFromResources = imageSourceModule.fromResource("icon");

Pour ajouter une image à partir d'un fichier local, utilisez la commande ci-dessous -

const folder = fileSystemModule.knownFolders.currentApp(); 
const path = fileSystemModule.path.join(folder.path, "images/sample.png"); 
const imageFromLocalFile = imageSourceModule.fromFile(path);

Pour enregistrer l'image dans le chemin du fichier, utilisez la commande ci-dessous -

const img = imageSourceModule.fromFile(imagePath); 
const folderDest = fileSystemModule.knownFolders.documents(); 
const pathDest = fileSystemModule.path.join(folderDest.path, "sample.png"); 
const saved = img.saveToFile(pathDest, "png"); if (saved) { 
   console.log(" sample image saved successfully!"); 
}

Minuteur

Ce module est utilisé pour exécuter du code à des intervalles de temps spécifiques. Pour ajouter cela, nous devons utiliserrequire -

const timerModule = require("tns-core-modules/timer");

Il repose sur deux méthodes -

setTimeout- Il est utilisé pour retarder l'exécution. Il est représenté en millisecondes.

setInterval - Il est utilisé pour appliquer de manière récurrente à des intervalles spécifiques.

Trace

Ce module est utile pour le débogage. Il donne les informations de journalisation. Ce module peut être représenté par -

const traceModule = require("tns-core-modules/trace");

Si vous souhaitez activer dans votre application, utilisez la commande ci-dessous -

traceModule.enable();

ui / image-cache

Le module image-cache est utilisé pour gérer les demandes de téléchargement d'images et met en cache les images téléchargées. Ce module peut être représenté comme indiqué ci-dessous -

const Cache = require("tns-core-modules/ui/image-cache").Cache;

connectivité

Ce module permet de recevoir les informations de connexion du réseau connecté. Il peut être représenté par -

const connectivityModule = require("tns-core-modules/connectivity");

Modules de fonctionnalité

Les modules de fonctionnalité comprennent de nombreux modules spécifiques au système / à la plate-forme. Certains des modules importants sont les suivants -

platform- Utilisé pour afficher les informations sur votre appareil. Il peut être défini comme indiqué ci-dessous -

const platformModule = require("tns-core-modules/platform");

fps-meter- Utilisé pour capturer des images par seconde. Il peut être défini comme indiqué ci-dessous -

const fpsMeter = require("tns-core-modules/fps-meter");

file-system- Utilisé pour fonctionner avec le système de fichiers de votre appareil. Il est défini ci-dessous -

const fileSystemModule = require("tns-core-modules/file-system");

ui/gestures - Utilisé pour travailler avec les gestes de l'interface utilisateur.

Module d'interface utilisateur

Le module d'interface utilisateur comprend le composant d'interface utilisateur et ses fonctionnalités associées. Certains des modules d'interface utilisateur importants sont les suivants:

  • frame

  • page

  • color

  • text/formatted-string

  • xml

  • styling

  • animation