NativeScript-モジュール

_NativeScript Module_には、単一のライブラリとしてパッケージ化された一連の関連機能が含まれています。 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-保存された値をクリアします
削除-キーに基づいてエントリを削除します。

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

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* -2つの引数URLとファイルパスがあります。

URL -データをダウンロードします。
ファイルパス-URLデータをファイルに保存します。以下に定義されています-

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

リクエスト-オプション引数があります。これは、オプションを要求して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

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

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

接続性

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

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

機能モジュール

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

プラットフォーム-デバイスに関する情報を表示するために使用されます。それは以下のように定義することができます-

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モジュールのいくつかは次のとおりです-

枠
page
色
text/formatted-string
xml
スタイリング
アニメーション

Nativescript-modules

目次