NativeScript-モジュール

A NativeScriptモジュールは、単一のライブラリとしてパッケージ化され、関連する機能のセットが含まれています。NativeScriptフレームワークによって提供されるモジュールを学びましょう。

これには、NativeScriptフレームワークのコア機能が含まれています。この章のコアモジュールを理解しましょう。

応用

アプリケーションには、モバイルアプリケーションのプラットフォーム固有の実装が含まれています。単純なコアモジュールは以下に定義されています-

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

コンソール

コンソールモジュールは、メッセージをログに記録するために使用されます。以下の方法があります-

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

アプリケーションの設定

application-settingsモジュールには、アプリケーション設定を管理するためのメソッドが含まれています。このモジュールを追加するには、次のコードを追加する必要があります-

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

アプリケーション設定で利用できる方法は次のとおりです。

  • setBoolean(key:string、value:boolean)-ブールオブジェクトを設定します

  • setNumber(key:string、value:number)-セット番号オブジェクト

  • setString(key:string、value:string)-文字列オブジェクトを設定します

  • getAllKeys()-保存されているすべてのキーが含まれます

  • hasKey(key:string)-キーが存在するかどうかを確認します

  • clear-保存された値をクリアします

  • remove-キーに基づいてエントリを削除します。

アプリケーション設定を使用した簡単な例は次のとおりです。

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

このモジュールは処理に使用されます http要求と応答。このモジュールをアプリケーションに追加するには、次のコードを追加します-

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

以下の方法でデータを送信できます-

getString−リクエストを行い、URLから文字列としてデータをダウンロードするために使用されます。以下に定義されています-

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

getJSON−JSONからデータにアクセスするために使用されます。以下に定義されています-

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

getImage−指定されたURLからコンテンツをダウンロードし、ImageSourceオブジェクトを返します。以下に定義されています-

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

getFile −URLとファイルパスの2つの引数があります。

  • URL −データをダウンロードします。

  • File path−URLデータをファイルに保存します。以下に定義されています-

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

request−オプション引数があります。オプションを要求し、HttpResponseオブジェクトを返すために使用されます。以下に定義されています-

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

画像ソース

image-sourceモジュールは画像の保存に使用されます。以下のステートメントを使用して、このモジュールを追加できます-

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

リソースから画像をロードする場合は、以下のコードを使用してください-

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

ローカルファイルから画像を追加するには、以下のコマンドを使用します-

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

画像をファイルパスに保存するには、以下のコマンドを使用します-

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!"); 
}

タイマー

このモジュールは、特定の時間間隔でコードを実行するために使用されます。これを追加するには、を使用する必要がありますrequire

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

それは2つの方法に基づいています-

setTimeout−実行を遅らせるために使用されます。ミリ秒で表されます。

setInterval −特定の間隔で繰り返し適用するために使用されます。

痕跡

このモジュールはデバッグに役立ちます。ロギング情報を提供します。このモジュールは次のように表すことができます-

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

アプリケーションで有効にする場合は、以下のコマンドを使用します-

traceModule.enable();

ui / image-cache

image-cacheモジュールは、画像のダウンロード要求を処理し、ダウンロードされた画像をキャッシュするために使用されます。このモジュールは、次のように表すことができます-

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

接続性

このモジュールは、接続されたネットワークの接続情報を受信するために使用されます。−として表すことができます

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

機能モジュール

機能モジュールには、多くのシステム/プラットフォーム固有のモジュールが含まれます。重要なモジュールのいくつかは次のとおりです-

platform−デバイスに関する情報を表示するために使用されます。以下のように定義できます-

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

fps-meter−1秒あたりのフレーム数をキャプチャするために使用されます。以下のように定義できます-

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

file-system−デバイスファイルシステムの操作に使用されます。以下に定義されています-

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

ui/gestures −UIジェスチャを操作するために使用されます。

UIモジュール

UIモジュールには、UIコンポーネントとそれに関連する機能が含まれています。重要なUIモジュールのいくつかは次のとおりです-

  • frame

  • page

  • color

  • text/formatted-string

  • xml

  • styling

  • animation