آموزش ماژول ها در NativeScript

آموزش ماژول ها در NativeScript

در این درس از مجموعه آموزش برنامه نویسی سایت سورس باران، به آموزش ماژول ها در NativeScript خواهیم پرداخت.

یک ماژول 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");

تنظیمات برنامه

ماژول تنظیمات برنامه شامل روشی برای مدیریت تنظیمات برنامه است. برای افزودن این ماژول ، باید کد زیر را اضافه کنیم –

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

چند روش موجود در تنظیم برنامه به شرح زیر است –

• setBoolean (کلید: رشته، مقدار: بولی) – تنظیم شی. بولی
• setNumber (کلید: رشته، مقدار: تعداد) – مجموعه تعداد شی
• setString (کلید: رشته، مقدار: رشته) – شی رشته را تنظیم می کند
• ()getAllKeys  – شامل تمام کلیدهای ذخیره شده است
• hasKey (کلید: رشته) – بررسی کنید که آیا یک کلید وجود دارد یا خیر
• 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 و مسیر پرونده است.

• URL – داده ها را بارگیری می کند.
• مسیر پرونده – داده های URL را در پرونده ذخیره کنید. در زیر تعریف شده است –

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

request – آرگومان گزینه هایی دارد. برای درخواست گزینه ها و بازگرداندن شی object HttpResponse استفاده می شود. در زیر تعریف شده است –

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

منبع تصویر

ماژول منبع تصویر برای ذخیره تصویر استفاده می شود. ما می توانیم این ماژول را با استفاده از دستور زیر اضافه کنیم –

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

تایمر

این ماژول برای اجرای کد در بازه های زمانی خاص استفاده می شود. برای اضافه کردن این ، ما نیاز به استفاده از –

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

این بر اساس دو روش است –

• setTimeout – برای به تأخیر انداختن اجرا استفاده می شود. به صورت میلی ثانیه نشان داده می شود.
• setInterval – برای اعمال تکراری در فواصل زمانی مشخص استفاده می شود.

Trace

این ماژول برای رفع اشکال مفید است. این اطلاعات ورود به سیستم را می دهد. این ماژول را می توان به عنوان –

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

ماژول های عملکردی

ماژول های عملکردی شامل بسیاری از ماژول های خاص سیستم / سیستم عامل هستند. برخی از ماژول های مهم به شرح زیر است –

platform – برای نمایش اطلاعات دستگاه شما استفاده می شود. می توان آن را به صورت زیر تعریف کرد –

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

fps-meter – برای گرفتن فریم در ثانیه استفاده می شود. می توان آن را به صورت زیر تعریف کرد –

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

file-system – برای کار با سیستم فایل دستگاه شما استفاده می شود. در زیر تعریف شده است –

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

ui / gestures – برای کار با حرکات رابط کاربر استفاده می شود.

ماژول UI

ماژول UI شامل مولفه UI و عملکرد مربوط به آن است. برخی از ماژول های UI مهم به شرح زیر است:

• قاب
• صفحه
• رنگ
• رشته / قالب بندی شده
• xml
• طراحی ظاهر
• انیمیشن

منبع.

لیست جلسات قبل آموزش NativeScript

1. آموزش NativeScript
2. معرفی NativeScript
3. آموزش نصب NativeScript
4. آموزش معماری NativeScript
5. آموزش برنامه Angular در NativeScript
6. آموزش تمپلیت ها در NativeScript
7. آموزش ویجت ها در NativeScript
8. آموزش ظروف طرح بندی در NativeScript
9. آموزش پیمایش در NativeScript
10. آموزش مدیریت رویدادها در NativeScript
11. آموزش اتصال داده در NativeScript