مقالات تخصصی طراحی اپلیکیشن در مشهد

 

Dagger 2 در اندروید (نصیب اولیه) – راهنمای توسعه یافته

Dagger یک زمینه متناقض در جامعه اندروید محسوب میشود. دعوا‌های و پیکار‌های بی‌شماری پیرامون آن صورت گرفته میباشد و اکثری از اشخاص بارها نظرخود را در باب آن تغییر تحول داده‌اند. اکثر وقت ها نرم افزار‌نویس‌ها سوابق‌ای از پیشرفت دهندگی دارا هستند که در آن تزریق تعلق کاری سهل وآسان به حساب می‌آید و از این رو تایید ابهام Dagger به فرصت بیشتری نیاز دارااست که در اکثر زمان ها موردها بسیار بیشتر از مقدار گزینه انتظار میباشد.

امروزه ما در کاتلین با جایگزین‌های جذابی مانند Koin یا این که Kodein مواجه هستیم و برخی اشخاص در‌این مسیر تکان می‌نمایند. با این حالا شاید اطلاق کلمه جایگزین برای این مفاد صحیح نباشد، چون آن ها بیشتر خدمت یاب (service locator) میباشند تا یک تزریق کننده طراحی اپلیکیشن در مشهد  حقیقی وواقعی تعلق.

 

البته در غایت می توانیم توافق کنیم که با وجود کلیه علاقه و تنفری که در زمینه‌ی Dagger وجود داراست، Dagger یک کتابخانه کارکشته و طریق سفارش گردیده قانونی برای تزریق تعلق در نرم افزار‌های اندروید میباشد.

 

با در حیث اعلام کردن حقیقت فوق متوجه می‌شویم که طرز‌های بسیار مختلفی چهت نیل به هدف ها شبیه از روش Dagger وجود دارا هستند که بعضا از آنها بسیار غامض محسوب می شوند. ما درین نوشته به رسیدگی رویکردهای متفاوت پرداخته و طرز مطلوب را به شما توضیح می دهیم.

 

یک سری پیشنهاد کلی

در زمینه‌ی همگی کلاس‌هایی که می‌نویسید از «تزریق ساختار» (Construction Injection) استعمال فرمائید.

به مکان کامپوننت‌های فرعی، حوزه تعریف و تمجید (Scope) را با به کارگیری از ViewModel در اختیار گرفتن فرمائید.

وجود dagger-android را فراموش نمائید.

دیباچه

در‌این نوشته‌ی علمی فرض می کنیم که شما پیش از اینً تجربیاتی با Dagger داشته‌اید. در شرایطی‌که اینگونه وجود ندارد، سفارش می کنیم پیش از بازرسی ادامه این نوشته‌ی علمی به بعضا راهنماهای جانور در این باره مراجعه نمایید. همینطور تمامی مواقعی که در‌این نوشته مطرح میشوند در یک نرم افزار معمولی در‌این نشانی (+) پیاده‌سازی گردیده‌اند که سفارش میکنیم آن را نیز پژوهش نمایید. سعی گردیده این نرم افزار تا حد قابلیت خرد باشد تا فقطً روی سوژه Dagger تمرکز کنیم.

 

تزریق ساختار

یکی مواقعی که در Dagger به طور کاملً نادیده گرفته گردیده، گفت و گو «تزریق ساختار» (Construction Injection) میباشد. گه گاه ما چنان به استعمال از ماژول‌ها عادت میکنیم که فراموش می کنیم مورد اجتناب بی نقص از تایپ کردن «متدهای خالق» (Constructor) نیز وجود داراست. به حیث میرسد این دقیقاً مزیت کلیدی Dagger نسبت به Koin و Kodein میباشد.

شایسته ترین قسمت تزریق ساختار این میباشد که میتوانیم کلیه داده ها مرتبط را در یک جای یعنی اعلان کلاس نگه‌داری کنیم. در صورتی‌که کلاس قابل تزریق باشد و در‌حالتی که یک سینگلتون باشد یا این که نباشد، شما میتوانید در شکل استعمال از تزریق ساختار، تمامی داده ها را با یک نگاه زود گذر به کلاس ببینید.

 

اما در حالتی‌که شما صاحب کلاس نباشید، نمی‌توانید از ماژول‌ها و کدهای تکراری آفریننده گریز نمائید؛ البته اجرا طرز فوق در امر کلیه کلاس‌های پایین مالکیت خودتان ایده قابل قبولی به حیث میرسد. به صورت خلاصه می‌قدرت اعلام‌کرد که خوب میباشد کدی به طور ذیل داشته باشیم:

 

@Reusable

class BestPostFinder @Inject constructor() {

...

}

تا این که کدهایی به طور پایین بنویسیم:

 

@Module

object PostModule {

 

@JvmStatic @Provides @Reusable

fun provideBestPostFinder() = BestPostFinder()

}

زمانی که آغاز به اضافه کردن تعلق‌هایی بکنید که خودشان فهرست بزرگی از تعلق‌ها دارا‌هستند، ماژول‌ها به صورت در اختیار گرفتن نشده‌ای استارت به تعالی شدن می‌نمایند و خیلی زود به حالت نامناسبی میرسید.

 

کامپوننت‌های فرعی و منطقههای تعریف‌و‌تمجید

در شرایطی که «کامپوننت‌های فرعی» (Subcomponents) دارای اهمیت بالایی برای شما میباشند، دستور کار فوق ممکن میباشد نیازهای شمارا رفع نکند، البته در اکثر زمان ها پروژه‌ها میتواند راهگشا باشد. در واقع اکثر اوقات موردها کاربرد کامپوننت‌های فرعی ضرورتی ندارد؛ ولی به جهت بهبود بی آلایش در سازماندهی تعلق‌ها به کارگیری می گردند. در مستندات (+) ایده به کار گیری از «کامپوننت‌های فرعی به مکان کپسوله‌سازی» مطرح گردیده است؛ البته بخش اعظمی از اشخاص با این ایده مخالف می باشند. اضافه کردن کدهای تکراری تولید کننده که در شکل به کارگیری از تزریق ساختار قابل اجتناب میباشد به سازمان‌یافتگی بیشتر کد به خصوص در بلند دوران یاری می‌نماید.

مقصود دیگر کامپوننت‌های فرعی، استخراج به حیطههای تعریف و تمجید سفارشی میباشد. با این اکنون، امروزه این اعتقاد و باور وجود داراست که ViewModel و حوزه تعریفی که به طور آزاد ارائه می‌نمایند، کامپوننت‌های فرعی Dagger و منطقههای تعریفشان دیگر ارزشمندی دیرین را ندارند. فعلا اندروید حیطههای Activity و Fragment را به طور فراهم در مشت ما قرار می دهد و از این رو تا وقتیکه تعلق‌های سوای حوزه تعریف‌و‌تمجید شما در ViewModel قرار دارا هستند، از حوزه تمجید آن به کارگیری می‌نمایند و از این رو هیچ نگرانی دراین باره نیست.

 

با این وجود برخی کاربردهای دیگر مانند مواقعی که میخواهیم یک Activity در گراف داشته باشیم، نیز می‌باشند که ممکن میباشد کامپوننت‌های فرعی در آن ها اثر گذار باشند. دقت فرمایید که ما به کارگیری از کامپوننت‌های فرعی در همگی جا را کاملا رد نمی‌کنیم؛ البته اشاره می کنیم که در‌صورتی‌که از آنان تنهاً برای سازماندهی تعلق‌ها یا این که تولید حیطههای تعریف و تمجید سفارشی Activity/Fragment به کارگیری میکنید، احتمالاً مجال معمولی‌خیس ساختن پیکربندی Dagger را از دست می‌دهید.

 

تزریق تعلق در ViewModel با به کارگیری از Dagger ممکن میباشد در صدر بغرنج به لحاظ بیاید. در صورتی‌که به کدهای مثال معماری اندروید ارائه گردیده از سوی گوگل (+) نگاه فرمائید مثالی را می یابید که مشتمل بر نقش‌آفرینی هر دو گزینه ViewModels و Dagger میباشد؛ البته در شرایطی که به مثال‌های کامپوننت معماری (+) نگاه فرمایید، GithubBrowserSample (+) را میبینید که آن ها را با هم به کار گیری نموده است. در صورتی‌که به نمونه GithubViewModelFactory (+) نگاه فرمائید ممکن میباشد به وحشت بیفتید.

 

 

در غایت بایستی اشاره کنیم که طرز آیتم تأکید ما، میتواند در شغل بسیار معمولی‌خیس از آن چیزی باشد که تصور می کنید. تمامی آن چه نیاز دارید این میباشد که یک annotation به طور Inject@ در خالق ViewModel خویش اضافه فرمایید و ViewModelFactory زیبای پایین این عمل را برای شما اجرا می دهد:

 

class ViewModelFactory @Inject constructor(

private val viewModel: Lazy

) : ViewModelProvider.Factory {

 

@Suppress("UNCHECKED_CAST")

override fun create(modelClass: Class) = viewModel.get() as T

}

فعلا میتوانید به آسانی آن ViewModelFactory را تزریق فرمائید و از آن برای ایجاد کرد هر ViewModel که میخواهید به طور تحت منفعت بگیرید:

 

class BestPostActivity : AppCompatActivity() {

 

private val viewModel by lazy {

ViewModelProviders

.of(this, injector.bestPostViewModelFactory())

.get(BestPostViewModel::class.java)

}

 

...

}

با اعتنا به‌این که ما عملاً نیازی به مراقبت ارجاعی برای ViewModel برای دسترسی‌های آجل نداریم؛ عالی میباشد به مکان پیچیدن ViewModel در یک Lazy در ViewModelFactory، آن را در یک Provider بپیچید. عامل این که آن را در نوبت ابتدا به آن شکل می‌پیچیم آن میباشد که از جمله ما یحتاج وجود ندارد ViewModel و تعلق‌هایش را در حین تغییر تحول جهت‌گیری، مجدداً ساخت کنیم. چنانچه فکر می کنید این injector تعجب آور میباشد، در‌پی راجع‌به آن بیشتر توضیح داده‌ایم.

 

ما قادر خواهیم بود این حالت را با نرم افزار ارائه گردیده در کنفرانس I/O 2018 گوگل (Google I/O 2018 app) مقایسه کنیم. این پیکربندی اندکی متعدد از GithubBrowserSample میباشد. و بی آلایش‌خیس محسوب می‌شود؛ البته یک سری factory (به طور یک کدام از برای هر ViewModel) وجود داراست و همچنان غامض‌خیس از چیزی میباشد که ما جاری ساختن کرده‌ایم.

 

درصورتی که به پیکربندی ارائه گردیده درین نوشته عشق و علاقه‌مند می‌باشید، سفارش میکنیم گزینه ارائه گردیده از سوی Gabor Varadi (+) را نیز پژوهش فرمائید. ما برای این پیکربندی نیز در نرم افزار خویش یک شاخه (+) ساخت و ساز کرده‌ایم. نرم افزار I/O گوگل و هم اینگونه GithubBrowserSample از dagger-android به کار گیری کرده‌اند، بدین ترتیب پیرو درخصوص آن کلام میکنیم.

 

dagger-android

بر پایه ی مستندات dagger، علت اساسی پیاده سازی آن بی آلایش‌سازی طرز تزریق مورد ها متعدد در اکتیویتی‌ها و فرگمان‌هایی بوده میباشد که در بالا از سوی خویش سیستم ادله مقداردهی اول گردیده‌اند، و از این رو قابلیت و امکان به کارگیری از تزریق آفریننده وجود نداشت. این حالت باعث به کدی مانند پایین میشد:

 

((SomeApplicationBaseType) getContext().getApplicationContext())

.getApplicationComponent()

.newActivityComponentBuilder()

.activity(this)

.build()

.inject(this);

در واقع کد فوق نماد دهنده سناریوی بدترین شرایط میباشد و در اکثر زمان ها مورد ها شرایط به‌این بدی وجود ندارد. البته در هر اکنون این یک حقیقت دارای اعتبار میباشد. به صورت معمول Activity (یا این که Fragment) نباید راجع‌به تزریق کننده خودشان اطلاعاتی داشته باشند. با این وجود، ما برای غلبه بر این شرایط به همگی مواقعی که dagger-android ارائه می‌نماید به خصوص درباره ی به کار گیری از کامپوننت‌های فرعی، نیاز نداریم. به مکان آن قادر خواهیم بود از کد ذیل به کارگیری کنیم:

 

interface DaggerComponentProvider {

 

val component: ApplicationComponent

}

 

val Activity.injector get() = (application as DaggerComponentProvider).component

در این‌حالت کلاس نرم افزار، DaggerComponentProvider را پیاده‌سازی می‌نماید و component را از روش آن ارائه می‌نماید و به لطف آسانی بیشتراز حد این اکستنشن، قادر خواهیم بود چیزهایی که در یک Activity قرار دارا هستند را با یک ()injector.inject بی آلایش تزریق کنیم. در این‌حالت Activity چیزی در باب تزریق کننده خویش نمی‌داند و تنظیمات Dagger ما نیز همچنان معمولی و فهم آن راحت میباشد.

 

صحبت نهایی

آنچه درخصوص dagger-android بیشتر آزار میدهد، ترازو دشواری فعال سازی آن میباشد و ادله آوازه منفی Dagger در زمینه ی عدم وضوح نیز همین آیتم میباشد. در شرایطی‌که فکر‌می‌کنید‌ در خصوص ترک dagger-android از پروژه‌تان به دلایل بیشتری نیاز دارید می توانید به موردها مطرح گردیده درین نوشته ی علمی (+) مراجعه‌نمایید.

 

 

آپلود پوشه و اکران جلو رفتن آن در کاتلین – از صفر تا صد

در‌حالتی که میخواهید یک پوشه را با به کارگیری از ساختار سرراست Retrofit آپلود نمایید، شاید متوجه گردید که قابلیت و امکان اخذ سود و همینطور اکران نوار جلو رفتن در کاتلین را ندارید. ما درین نوشته‌ی‌علمی از Retrofit برای آپلود فولدر استعمال می کنیم و ساختاری پیاده‌سازی می کنیم که قابلیت و امکان اخذ معیار توسعه و گسترش عمل را در برهه زمانی‌های هنگامی متعدد داراست و نهایتاً با کامل شدن جواب API ریموت، ‌نقطه طراحی اپلیکیشن در مشهد نهایی مییابد.

هر فرصت که عملیاتی بلندمدت در اکنون ایفا میباشد، بهتر میباشد که فرایند جلو رفتن عمل را به مخاطب نماد دهیم. در زمینه ی آپلود فولدر میتوانیم بسط حقیقی و واقعی عمل را که بر حسب بایت‌های جابجایی‌یافته از آحاد اندازه پوشه به حساب آوردن میشود به استفاده کننده علامت دهیم.

 

درپی از API-های جان دار در کتابخانه‌های Retrofit ،OkHttp و Okio برای تشکیل داد یک کلاس به کار گیری می کنیم که برای اکران فرآیند جلو رفتن آپلود فولدر گزینه به کارگیری قرار میگیرند.

نقطه انتهایی

فرض فرمایید در هم اکنون گسترش یک نرم افزار پیام‌رسانی هستیم که قابلیت و امکان الصاق پوشه به حرفه پیام را دارااست. قابل ذکر میباشد که‌این کامپوننت واکنشی از RxJava به کارگیری می‌نماید، ولی می‌اقتدار از Callback-های بی آلایش یا این که کوروتین‌ها و تابع‌های تعلیقی کاتلین نیز به کار گرفت.

 

نقطه انتهایی (endpoint) ما یک درخواست POST میباشد که دربرگیرنده بدنه چندبخشی میباشد که از اجزای اسم فولدر، نوع MIME پوشه، ‌اندازه فولدر و خویش فولدر تشکیل یافته میباشد. آن را می توانیم با استعمال از Retrofit و با گزینش قسمت‌های مورد نیاز به روش‌ای همانند کد پایین تعریف و تمجید کنیم:

 

@Multipart

@POST("file")

fun attachFile(

@Part("name") filename: RequestBody,

@Part("type") mimeType: RequestBody,

@Part("size") fileSize: RequestBody,

@Part filePart: MultipartBody.Part

): Single

شمارش جلو رفتن

درصورتی که تنهاً می‌خواستیم پوشه را سوای اکران مراحل توسعه و گسترش، آپلود کنیم، کافی بود فولدر را به بدنه درخواست تبدیل کنیم و آن را در درخواست خویش بفرستیم.

 

fun createUploadRequestBody(file: File, mimeType: String) =

file.asRequestBody(mimeType.toMediaType())

رسیدگی بر گسترش آپلود نیز با به کار گیری از CountingRequestBody نتایج میگردد که در پوشه RequestBody جای دارد و تا قبل از اینً استعمال کردیم. داده‌هایی که ارسال میشوند همچون قبلی می باشند و به فولدر ناپخته RequestBody قابلیت و امکان میدهیم که نماینده نوع محتوا و ارتفاع محتوا باشد.

 

class CountingRequestBody(

private val requestBody: RequestBody,

private val onProgressUpdate: CountingRequestListener

) : RequestBody() {

override fun contentType() = requestBody.contentType()

 

@Throws(IOException::class)

override fun contentLength() = requestBody.contentLength()

 

...

}

جابجایی بدنه درخواست با تایپ کردن یک Sink جاری ساختن مییابد و Sink پیش‌فرض را داخل آن Sink قرار میدهیم که بایت‌های انتقالی را می‌شمارد و آنها را از روش یک Callback جلو رفتن رجوع میدهد.

 

typealias CountingRequestListener = (bytesWritten: Long, contentLength: Long) -> Unit

 

class CountingSink(

sink: Sink,

private val requestBody: RequestBody,

private val onProgressUpdate: CountingRequestListener

) : ForwardingSink(sink) {

private var bytesWritten = 0L

 

override fun write(source: Buffer, byteCount: Long) {

super.write(source, byteCount)

 

bytesWritten += byteCount

onProgressUpdate(bytesWritten, requestBody.contentLength())

}

}

مشاهده بی نقص کدها

داخل CountingRequestBody خواهیم توانست Sink پیش‌فرض را در CountingSink تازه خویش در اختیار بگذاریم و ورژن بافر گردیده‌ی آن را بنویسیم تا هم فولدر جابجایی یابد و هم مراحل جلو رفتن را ببینیم.

 

class CountingRequestBody(...) : RequestBody() {

...

 

@Throws(IOException::class)

override fun writeTo(sink: BufferedSink) {

val countingSink = CountingSink(sink, this, onProgressUpdate)

val bufferedSink = countingSink.buffer()

 

requestBody.writeTo(bufferedSink)

 

bufferedSink.flush()

}

}

فیض

در طول مشاهده جلو رفتن پروسه آپلود، ‌دو موقعیت وجود داراست یا این که پوشه در اکنون آپلود شدن میباشد و یا این که عمل به اتمام رسیده و از این رو خوب میباشد از یک کلاس مهروموم‌گردیده (sealed) استعمال کنیم. این کلاس قابلیت می دهد که یک نوع بازگشتی CountingRequestResult داشته باشیم و فراخوانی‌کننده‌ها میتوانند هم به‌روزرسانی‌های جلو رفتن به و هم فیض کامل شدن‌گردیده را رئیس نمایند.

 

sealed class CountingRequestResult {

data class Progress(

val progressFraction: Double

) : CountingRequestResult()

 

data class Completed(

val result: ResultT

) : CountingRequestResult()

}

اجرای آپلود

در حال حاضر که روشی برای آپلود کردن پوشه و اخذ پروسه جلو رفتن آپلود یافتیم، می توانیم FileUploader خویش را بنویسیم. ساخت‌و‌ساز بدنه درخواست برای درخواست آپلود دربرگیرنده به کارگیری از CountingRequestBody میباشد که جلو رفتن و کامل شدن را به یک PublishSubject گزارش میدهد.

 

private fun createUploadRequestBody(

file: File,

mimeType: String,

progressEmitter: PublishSubject

): RequestBody {

val fileRequestBody = file.asRequestBody(mimeType.toMediaType())

return CountingRequestBody(fileRequestBody) { bytesWritten, contentLength ->

val progress = 1.0 * bytesWritten / contentLength

progressEmitter.onNext(progress)

 

if (progress >= 1.0) {

progressEmitter.onComplete()

}

}

}

مشاهده بدون نقص کدها

درخواست آپلود مشمول به کارگیری از تابع Retrofit میباشد که در اولِ نوشته‌ی علمی پیاده‌سازی کردیم و جزئییات پوشه و بدنه ساخت و ساز گردیده درخواست که روند جلو رفتن را گزارش میدهند. تعریف‌و‌تمجید Retrofit و پوسته قسمت‌های درخواست به طرز خاص هر API بستگی دارا‌هستند. درین نوشته‌ی‌علمی ما از یک درخواست به کارگیری می کنیم که مشمول قسمت‌های متنی معمولی مختلفی برای ریزه کاری پوشه میباشد و بعد یک قسمت برای خویش فایلی که قرار میباشد آپلود خواهد شد، ارائه می‌نماید.

 

private fun createUploadRequest(

filename: String,

file: File,

mimeType: String,

progressEmitter: PublishSubject

): Single {

val requestBody = createUploadRequestBody(file, mimeType, progressEmitter)

return remoteApi.attachFile(

filename = filename.toPlainTextBody(),

mimeType = mimeType.toPlainTextBody(),

fileSize = file.length().toString().toPlainTextBody(),

filePart = MultipartBody.Part.createFormData(

name = "files[]",

filename = filename,

body = requestBody

)

)

}

 

private fun String.toPlainTextBody() = toRequestBody("text/plain".toMediaType())

مشاهده بی نقص کدها

تابع مهم آپلود ما می تواند همگی این قسمت‌ها را کنار هم قرار داده و یک استریم منفرد ساخت‌و‌ساز نماید. به این ترتیب خواهیم توانست این پروسه را مشاهده کرده و فرآیند جلو رفتن آپلود را نیز در فیض پایانی ببینیم.

 

fun uploadAttachment(

filename: String, file: File, mimeType: String

): Observable {

val progressEmitter = PublishSubject.create()

val uploadRequest = createUploadRequest(

filename, file, mimeType, progressEmitter

)

 

val uploadResult = uploadRequest

.map {

CountingRequestResult.Completed(it.result)

}

.toObservable()

 

val progressResult = progressEmitter

.map {

CountingRequestResult.Progress(it)

}

 

return progressResult.mergeWith(uploadResult)

}

 

typealias AttachmentUploadRemoteResult =

CountingRequestResult

مشاهده بی نقص کدها

اینک خواهیم توانست پوشه را به API خویش آپلود کنیم و نما را به طور جلو رفتن‌های درخواست به‌روزرسانی کنیم که برای عملیات وقتگیر برهه زمانی مانند آپلود پوشه‌های حجیم اثر گذار میباشد.

 

uploader.uploadAttachment(request.filename, request.file, request.mimeType)

.subscribeOn(appRxSchedulers.io)

.observeOn(appRxSchedulers.main)

.subscribeBy(

onError = { error ->

// Display error alert

},

onComplete = {

// Display completed Snackbar

},

onNext = { progress ->

// Update progress bar

}

)

.addTo(disposeBag)

مشاهده بی نقص کدها

حرف نهایی

پژوهش بر گسترش یک درخواست اینترنت ممکن میباشد در طول تلاوت یک Retrofit API چندان بدیهی به لحاظ نرسد، ولی API-های قادر OkHttp و Okio می توانند این فعالیت را به خیر اعمال می دهند. خط مش‌حلی که درین راهنما معرفی کردیم، می تواند برای هر درخواست اینترنت جاری ساختن خواهد شد، زیرا شمارش جلو رفتن را می‌قدرت داخل هر RequestBody که مورد نیاز میباشد در درخواست ارسال خواهد شد قرار اعطا کرد.

 

 

قدم هشتم – آپلود فولدر Apk:

در قدم پایان از فرایند تصویب نرم افزار در گوگل پلی نیاز میباشد تا فولدر پایانی نرم افزار خویش را در درون کنسول آپلود فرمائید. در بخش App Releases که در نوار کناری جای دارد، شما سه مورد را برای تکثیر نرم افزار در گوگل پلی مشاهده خواهید طراحی اپلیکیشن در مشهد  کرد که مشمول

 

Production

Beta

Alpha

میباشد. بعداز اینکه یکی‌از مورد ها را گزینش کردید، بر روی مورد Edit Release زده و فولدر Apk یا این که App Bundle خویش را در قسمت تعبیه شما آپلود نمایید. در غایت بر روی مورد Review بزنید تا نرم افزار شما جهت نظارت به وسیله گوگل نبی خواهد شد. مراحل تحقیق به وسیله گوگل معمولا فی مابین 2 الی 7 روز ارتفاع می‌کشد و بعد از پذیرش بوسیله گوگل، نرم افزار در گوگل پلی منتشر گردد.

 

 

 

راهنمای گزینش شایسته ترین اپ نرم افزار ساز برای استخراج‌وکار شما

 

در دنیای امروز به خصوص بعداز انقلاب تکنولوژی، کلمه و واژه نرم افزار که به اختصار app نامیده می گردد، به‌تیتر یک کدام از پرتکرارترین کلمه ها در مکالمات روزانه ما به‌شمار می‌رود. در دنیای دیجیتال، نرم افزار در واقع به معنای اپ یا این که ابزاری میباشد که ما خواهیم توانست با نصب‌کردن آن بر روی سیستم هوشمند خویش از آن برای سهولت در اجرا بعضی امور و وظایف خویش استعمال کنیم.

در حالتی که شما هم یک کدام از علاقه مندان نرم افزار‌های موبایل می باشید و یا این که جدیدا یک تجارت جدید شالوده‌گذاری کرده‌اید و به اندیشه توسعه و گسترش و توسعه و گسترش دادن این تجارت می باشید، ممکن میباشد تا به اکنون به پندار پیاده سازی و تشکیل داد نرم افزار افتاده باشید و از خودتان بپرسید این فرایند چه‌گونه صورت گرفته و چه مراحلی داراست؟

پیاده سازی نرم افزار در واقع به روند‌ای گفته میگردد که در آن معمولا یک پیشرفت دهنده، شغل های فنی و نرم‌افزار نویسی تلفن همراه و یک طراح نیز شغل های مرتبط با پیاده سازی رابط کاربری و تجربیات کاربری را جاری ساختن می دهد.

روی هم رفته به مجموع قدم‌هایی که برای کدنویسی، پیاده سازی گرافیکی، آزمایش و کپی از یک نرم افزار ایفا می‌گردد، پیاده سازی نرم افزار می گویند. یک کدام از شیوه های پیاده سازی نرم افزار‌های تلفن همراه، به کارگیری از اپلیکیشن‌های اپلکیشن ساز میباشد که به طور مجانی یا این که مبلغی در مشت شما قرار میگیرد.

 

شایسته ترین اپلیکیشن ایجاد کرد نرم افزار فرنگی بدون‌پول و مبلغی

آشنایی شایسته ترین نرم‌افزار ایجاد کرد نرم افزار فرنگی به شما امداد می‌نماید که با اعتنا به نیاز خویش شایسته ترین تعیین را داشته باشید و به سود مناسب خویش برسید.

 

 

 

به‌دنبال به معرفی بعضی از آن ها میپردازیم تا بتوانید برای دانلود شایسته ترین نرم افزار ساز بدون پول یا این که مبلغی مبادرت فرمایید.

 

Appy pie :

این نرم افزار یکی اپ‌هایی میباشد که در کد نویسی و تشکیل داد نرم افزار به شما یاری می‌نماید و شما با استعمال از آن می توانید به طور مقرون به صرفه، سریع و با کمترین دردسر، پیاده سازی نرم افزار متبوع خویش را اعمال داده و آن را به بازدهی برسانید.

با به کار گیری از فایده‌گیری از این نرم افزار و پیاده سازی نرم افزار به‌امداد آن، شما میتوانید گسترش سریع‌تری نسبت به رقبایتان داشته باشید.

استعمال از اپلیکیشن‌ Appy pie نیاز به کدنویسی ندارد و این جای را به یوزرها خویش میدهد که فارغ از نیاز به کدنویسی نسبت به ایجاد کرد نرم افزار مدنظر خویش مبادرت نمایند.

 

Build fire:

دانلود شایسته ترین نرم افزار ساز بدون پول مستلزم آشنایی اشکال اپ‌های ایجاد کرد نرم افزار میباشد که ما همچنان به معرفی مختصر این نرم افزار‌ها میپردازیم.

این نرم افزار یکی از دیگر از ابزارهایی میباشد که به شما برای تشکیل داد نرم افزار دلخواه خودتان امداد می‌نماید و خصوصیت اساسی آن سیستم افزونه آن میباشد. هر نرم افزار، یا این که نرم افزار فروشگاهی که با این نرم افزار یا این که پلتفرم ساخته گردد، با دسته‌ای از افزونه‌ها و ویجت‌ها شغل می‌نماید. افزونه‌ها درواقع قابل انعطاف افزارهایی می باشند که به شما قابلیت افزودن قابلیت و امکان‌ها و آپشن‌های متعدد را به نرم افزار درحال ساختتان میدهند.

Build fire  در واقع به هیچگونه مهارت کدنویسی و یا این که دانش فنی و سوابق‌ نرم افزار نویسی احتیاج نداشته و این مسئله یکی خصوصیت‌های اصلی این نرم افزار به شمار می‌رود.

 

 

اپلیکیشن نویسی اندروید با موبایل های اندروید

اکثر وقت ها نرم افزار‌نویس‌ها، چه اشخاص جدید‌وارد به دنیای اپ‌نویسی و چه اشخاص پیش کسوت، اکثر زمان ها از مشقت بار‌افزارهایی مانند لپ‌تاپ و کامپیوتر فردی (PC) برای فعالیت نرم‌افزار‌نویسی استعمال می‌نمایند. وجود کیبورد و شیت‌اکران مطلوب، نقش مهمی در شغل اپ‌نویسی داراست. از سوی دیگر، اکثر اوقات ویرایشگر کد منبع (Source Code Editor)، دور و اطراف‌های پیشرفت یکدست (Integrated Development Environment | IDE) و دیگر ابزارهای نرم‌افزار‌نویسی، برای پلتفرم‌های دسکتاپ مشتمل بر ویندوز، مک و لینوکس بسط پیدا کرده‌اند. از همین رو و به دلایل متفاوت و متنوع دیگر، منابع آموزشی نرم‌افزار‌نویسی نیز روی گفت و گو اپلیکیشن‌نویسی  طراحی اپلیکیشن در مشهد در پلتفرم‌های دسکتاپ متمرکز گردیده‌اند.

 

 

 

کلیک نمائید

در مشاجره نرم‌افزار نویسی اندروید برای تلفن همراه های اندروید نیز به همین صورت میباشد و اکثر زمان ها نرم افزار‌نویسان اندروید روی دسکتاپ و با استعمال از ابزارهای جان دار برای نرم افزار‌نویسی اندروید در پلتفرم‌های دسکتاپ به شغل نرم‌افزار‌نویسی میپردازند. البته برخی از اشخاص سازه به لزوم یا این که حالت خاصی که دارا‌هستند، تصمیم به آن دارا هستند که اپلیکیشن‌نویسی را در گوشی بیاموزند. دلایل گوناگونی برای این مسئله وجود دارااست که به عنوان مثال آن می‌اقتدار در دسترس نبودن مشقت بار‌افزار ما یحتاج برای نرم افزار‌نویس در لحظه اعمال نرم افزار‌نویسی و یا این که عدم قابلیت و امکان دفاع طاقت فرسا‌افزار موردنیاز برای بعضی از اشخاص به ویژه اشخاص جدید‌ارد به دنیای اپلیکیشن‌نویسی اشاره نمود.

 

هرچند که با جستجوهای زیاد، می‌اقتدار اطلاعاتی پیرامون کیفیت اپ نویسی اندروید با تلفن همراه های اندروید پیدا کرد، البته مطلبی که در آن به زیرساخت‌های ما یحتاج برای نرم افزار نویسی اندروید با تلفن همراه های اندروید در کنار ابزارهای جانور برای این فعالیت پرداخته باشد واقعا در صورتیکه نادر نباشد، معدود میباشد. از این رو، در‌این مقاله به نحوه نرم‌افزار نویسی اندروید با موبایل‌های اندروید پرداخته شد‌ه‌است.

 

درپی مقاله نرم افزار نویسی اندروید با موبایل های اندروید آغاز به ابزارهای مورد نیاز برای اپ نویسی اندروید با موبایل های اندروید پرداخته گردیده و بعد از آن، به سوال‌های متداول مو جود درین راستا، جواب داده گردیده‌است.

 

 

ابزارهای موردنیاز برای اپلیکیشن نویسی اندروید با موبایل های اندروید

برای ایفا نرم‌افزار‌نویسی، صرف‌لحاظ از طاقت فرسا‌افزاری که استفاده کننده به کار گیری می‌نماید و پلتفرمی که در آن به نرم افزار‌نویسی میپردازد، نیاز به ابزارهایی میباشد. گفت و گو نرم افزار نویسی اندروید با تلفن همراه های اندروید نیز از این قاعده استثنا ندارد و اپلیکیشن‌نویس نیاز به نصب و استعمال از ابزارهای خاصی در تلفن همراه هوشمند خویش برای اجرا شغل نرم افزار‌نویسی داراست. درین قسمت از مقاله اپ نویسی اندروید با موبایل های اندروید این ابزارها گزینه نظارت قرار گرفته‌اند.

 

 

 

کلیک فرمائید

ویرایشگر کد

برای بسط اپ در تلفن همراه هوشمند، نیاز به یک ویرایشگر کد منبع میباشد. در اصل، یک ویرایشگر کد منبع این قابلیت را مهیا می‌نماید که شخص فولدر‌های متنی را بسازد و محتوای آن‌ها‌را که دربردارنده کدهای درج شده به لهجه‌های نرم افزار‌نویسی متفاوت میباشد بازنویسی نماید. به ذکر دیگر، ویرایشگر کد منبع همانجایی میباشد که کدنویسی در آن جاری ساختن می گردد. برای شناخت بیشتر با مضمون‌ ویرایشگر کد منبع و اشکال آن، تفحص مقاله «کد ادیتور چیست ؟ | شایسته ترین ویرایشگرهای کد — معرفی و مقایسه» توصیه میشود.

 

 

 

کلیک نمایید

صحیح مانند ویرایشگرهای کد منبع جان دار برای پلتفرم‌های دسکتاپ، از ویرایشگرهای کد تلفن همراه نیز می‌اقتدار برای پژوهش محتوای کد، کاوش در کد، بازنویسی سایز فونت، تعغییر شمای رنگی و دیگر موردها بهره مند شد. همینطور، امکان‌های برش دادن (Cut)، چسباندن (Paste) و نسخه برداری به دست آوردن (Copy) ‌نیز درین ویرایشگرهای متن در کنار بخش اعظمی از قابلیت و امکان‌های معمول و متداول البته بسیار کاربردی دیگر، وجود دارااست. قابلیت و امکان مدیر متن‌های کدبندی نویسه (Character Encoding) گردیده با UTF-8 و پر رنگ‌سازی نحو (Syntax Highlighting) نیز از سایر مواقعی محسوب میشوند که اکثر اوقات ویرایشگر کد آنان را در دست استفاده کننده قرار می دهند.

 

 

 

در مغازه قابل انعطاف‌افزارهای گوشی گوگل پلی (Google Play) در اندروید، قابل انعطاف‌افزارهای ویرایشگر کد زیادی وجود دارا‌هستند. اما به اشخاص نو‌وارد به دنیای اپلیکیشن‌نویسی پیشنهاد می‌گردد تا ورژن تلفن همراه ویرایشگرهای کد شناخته گردیده و دوستداشتنی را که در پلی استور نیز جان دار می‌باشند دانلود نمایند. از جمله، ویرایشگر کد ویم (Vim) که برای دسکتاپ وجود داراست و از محبوبیت قابل توجهی نیز میان اپ‌نویسان برخوردار‌است، ورژن موبایلی با تیتر DroidVim برای تلفن همراه‌های اندرویدی داراست که می‌اقتدار از آن برای نرم افزار نویسی اندروید با تلفن همراه های اندروید به کار گرفت. این ویرایشگر متن با قابلیت و امکان‌هایی که دارااست، بازنویسی کد و کدنویسی با شیت لمسی موبایل هوشمند را به تجربیات جالبی برای اپلیکیشن‌نویس مبدل می‌نماید.

 

 

 

دانلود DroidVim از گوگل پلی [+]

صفحه کلید مطلوب نرم‌افزار‌نویسی در گوشی

استعمال از کیبوردهای اندرویدی مطلوب نرم افزار‌نویسی تحت عنوان جایگزینی برای کیبوردهای معمول و پیش‌فرض موبایل‌ها، به کسانی که عشق‌مند به نرم افزار نویسی اندروید با موبایل های اندروید میباشند پیشنهاد می گردد.

 

 

 

کلیک نمایید

یک کدام از شایسته ترین کیبوردها درین راستا، Hacker’s Keyboard میباشد که تایپ کاراکترهای خاصی مانند براکت یا این که کولون را با قرار دادن آنان در یک چیدمان کلیدهای گوناگون، تسهیل و تسریع می‌نماید.

 

 

 

دانلود Hacker’s Keyboard از گوگل پلی [+]

 

 

Garbage Collector در دارت

Garbage Collector در دارت به طور Generational میباشد و مشمول دو مرحله میباشد: «جستجو فضای نو» (Young Space Scavenger) و «نماد‌گذاری برابر و گردآوری‌آوری‌کننده‌های طراحی اپلیکیشن در مشهد  روبشی» (Parallel Mark Sweep Collectors).

 

e

 

 

کلیک فرمایید

مجال‌بندی

جهت معدود‌خیس کردن تأثیرهای «توده آشغال» (Garbage Collection) روی نرم افزار و کوشش رابط کاربری، Garbage Collector قلاب‌هایی به موتور فلاتر تولید می‌نماید که هنگامی موتور تشخیص دهد نرم افزار بدون شغل میباشد و استفاده کننده تعاملی با آن ندارد، آغاز به عمل می‌نماید. براین اساس فرصتی در دست Garbage Collector قرار می گیرد تا فازهای جمع آشغال خویش را سوای تولید اشکالی در کوشش نرم افزار اعمال نماید.

 

Garbage Collector می تواند فشرده‌سازی لغزشی را نیز در طول این برهه زمانی‌های بیکاری اعمال نماید و براین اساس سربار خاطر را با کاستن از تکه تکه شدن (Fragmentation) یاد کم کند.

 

مرحله جستجو فضای تازه

این مرحله برای تمیز‌سازی اشیای با قدمت کوتاه مانند ویجت‌های بی‌شرایط به کارگیری میگردد. با این که‌این مرحله مسدودکننده میباشد؛ ولی بسیار سریع‌خیس از مرحله دوم نشان‌گذاری/روبش میباشد. مرحله دوم هنگامی یار با فرصت‌بندی اعمال گردد سبب ساز تولید تاخیر‌هایی در موادتشکیل دهنده بصری نرم افزار در حین جاری ساختن میگردد.

 

اشیاء بر پایه ی ماهیت خویش در فضای پیوسته‌ای از خاطر اختصاص می یابند و وقتی که شی ءها ساخت‌و‌ساز می شوند به فضای مو جود آتی یاد اختصاص می یابند تا وقتیکه تک تک فضای اختصاص‌یافته مالامال خواهد شد. دارت از اختصاص اشاره‌گر bump برای اختصاص سریع در فضای نو استعمال می‌نماید که موجب ارتقا سرعت قابل‌مراعات‌ای درین روند میگردد.

 

فضای تازه هنگام اختصاص یافتن اشیای نو مشتمل بر دو نصفه میباشد که به اسم نیم گوشه و کنار شناخته می شوند. هر توشه صرفا یک نصفه به کار گیری می گردد. در حالی که یک نصفه فعال میباشد، نصفه دیگر غیر فعال باقی میماند. اشیای تازه در نصفه فعال اختصاص می یابند و هنگامی که نصفه دیگر لبریز گردد، اشیای زنده از نصفه فعال به نصفه غیر فعال نسخه برداری میشوند و اشیای مرده نادیده گرفته می گردند. آن گاه نصفه غیر فعال، فعال می گردد و این پروسه تکرار میگردد.

 

برای انتخاب این که شی ءها زنده یا این که مرده می‌باشند، Collector از اشیای ریشه مانند متغیرهای پشته شروع می‌نماید و آنچه را ارجاع داده‌اند نظارت می‌نماید. آن‌گاه اشیای ارجاع یافته را جابجایی میدهد. درین مرحله نظارت می‌نماید که اشیای ارجاع یافته به کجا اشاره می‌نمایند و این اشیای ارجاع یافته را جابجایی میدهد. این پروسه تا‌وقتی‌که کلیه اشیای زنده جابجایی یابند تداوم می یابد. اشیای مرده دیگر هیچ ارجاعی ندارند و از این رو در آنجا باقی میمانند و در پی زمانی garbage collection آجل چهره بدهد، اشیای زنده روی آنها نسخه برداری می گردند.

 

 

Garbage Collection در مرحله جستجو فضای جدید

آرم‌گذاری برابر و روبش هم‌زمان

هنگامی که شی ها به قدمت معینی برسند به فضای یاد جدیدی جابجایی می یابند که از سوی collector نسل دوم یعنی mark-sweep مدیر می شود.

 

تکنیک توده آشغال در‌این قسمت دو مرحله دارااست: آغاز گراف شیء پیمایش میشود و اشیایی که هنوز گزینه به کار گیری می باشند نشان‌گذاری می شوند. در طول مرحله دوم، مجموع یاد نسخه برداری میشود و هر شیئی که آرم‌گذاری نشده میباشد حذف می گردد. بعد از آن کلیه فلگ‌ها منزه می گردند.

 

این صورت از جمع آشغال در مرحله نماد‌گذاری موجب انسداد می گردد، زیرا هیچ تغییری در یاد نمی‌تواند صورت بدهد و نخ رابط کاربری مسدود می گردد. این عده، فراوانی یه خرده دارااست و اشیای با قدمت کوتاه عموماً از سوی «جستجو فضای نو» مدیر می‌گردد؛ البته مواقعی وجود دارا هستند که سیستم مجال اجرای دارت بایستی آویزان خواهد شد تا این نوع جمع آشغال اعمال خواهد شد. با اعتنا به بضاعت فلاتر برای فرصت‌بندی توده، تأثیر این حالت اندک خواهد بود.

 

قابل ذکر میباشد که چنانچه یک نرم افزار از «فرضیه نسل ضعیف» تقلید نکند، یعنی اکثر اوقات اشیای آن در سن نادر نمیرند، دراین‌صورت این صورت از توده به مراتب بیشتر صورت میدهد. با دقت به طرز پیاده‌سازی ویجت‌های فلاتر این احتمال اندک میباشد؛ البته نکته‌ای میباشد که بایستی در خیال داشت.

 

ایزولت‌ها (Isolates)

قابل ذکر میباشد که ایزولت های فلاتر خاطر هیپ منحصر به فرد خویش را دارا هستند که غیر وابسته از همدیگر میباشند. از‌آنجا‌که هر ایزولت در یک نخ منقطع انجام می‌گردد، رویدادهای توده آشغال برای هر ایزولت تأثیری روی تلاش ایزولت های دیگر نخواهد داشت. استعمال از ایزولت ها جهت دوری از انسداد رابط کاربری و معدود کردن توشه پردازش شغل‌های هنگفت مطلوب میباشد.

 

صحبت آخری

در‌این نوشته به پژوهش نحوه استعمال از Garbage Collector قوی برای کاستن از تأثیرهای انسدادی روی داد عده آشغال در نرم افزار‌های فلاتر پرداختیم. بدین ترتیب نباید از Garbage Collector بترسید زیرا به بهبود کارکرد نرم افزار شما بسیار یاری می‌نماید.

 

 

تنظیمات پراکسی

در مشابه‌ساز اندروید، نرم افزار Settings را گشوده فرمائید.  طراحی اپلیکیشن در مشهد به مسیر ذیل بروید:

 

Network & internet >Wi-Fi >AndroidWifi

و بعد روی دکمه Edit بزنید.

 

 

ادامه تنظیمات پراکسی

آیتم Proxy را روی Manual قرار دهید. آیتم Proxy hostname و Proxy port را نیز بر همین شالوده تهیه نمائید. مقدار مورد Bypass proxy for را به طور 127.0.0.1,localhost تهیه و تنظیم کرده و Save را کلیک فرمائید.

 

در مشابه‌ساز اندروید، نرم افزار گوگل کروم را گشوده نمایید. به نشانی پایین بروید:

 

https://d1ahtucjixef4r.cloudfront.net/Exponent-1.14.0.apk

و فولدر APK را دانلود و نصب نمایید. در شکل نیاز، مجوزهای سیستم را به‌این مراد تهیه و تنظیم فرمایید.

 

در فضا پیشرفت Expo آیتم ...Open existing project را تعیین کرده و در پی نرم افزار React Native را گزینش کنید. به دنبال آیتم Expo XDE را تعیین و بعد Install Android App را کلیک فرمائید.

 

 

 

به این ترتیب APK که پیش از اینً نصب گردیده بود، کنسل نصب می‌گردد و با جدیدترین ورژن جایگزین می گردد. از آن‌جا که کوشش کرده‌اید، جدیدترین ورژن را سوای کنسل نصب ورژن دیرین، نصب نمایید در شرایطی که که مبادرت به کنسل نصب ورژن سابق ناموجود بکنید با خطایی مواجه می شوید.

 

براین اساس پیام «!Installation Success» ظواهر نمیشود و آیکون چرخان در حین کامل شدن شدن نصب به آسانی ناپدید میگردد. همچنان که در دور و بر توسعه و گسترش Expo می باشید، روی آیکون پیکربندی به صورت چرخ‌دنده کلیک فرمائید و آنگاه Host را به localhost تغییر تحول دهید.

 

 

 

در مشابه‌ساز اندروید پیکربندی مشابه‌ساز را از روش منوی سه‌نقطه (...) در سمت راست پنجره گشوده فرمایید.

 

 

 

برگه Snapshots را کلیک کرده و آنگاه دکمه Take Snapshot را کلیک فرمایید. براین اساس مطمئن می‌شویم که شغل ما تا به اینجا تمیز نخواهد شد. تنظیمات ما می بایست در حال حاضر در وضعیت کاری باشد.

 

قدم سوم: اجرای نرم افزار

در اندروید استودیو آیتم Tools و آن‌گاه AVD Manager را تعیین نمایید. در سمت راست، دکمه سبز رنگ پخش را بزنید. به این ترتیب مشابه‌ساز استارت به شغل می‌نماید. درپی میتوانید پنجره‌های AVD Manager و Android Studio را ببندید تا فقط مشابه‌ساز گشوده بماند.

 

 

کلیک نمایید

در خط دستور امر yarn android را در دایرکتوری ریشه پروژه React Native خویش اعمال فرمائید. در مشابه‌ساز اندروید، نرم افزار Expo را گشوده نمایید. برای یافتن نرم افزار Expo، روی نوار جستجوی گوگل به سمت بالا درگ نمایید و آن‌گاه Expo را بزنید.

 

 

 

شما میتوانید موشواره خویش را روی نرم افزار Expo کلیک کرده و نگهدارید تا آن را برای استعمال‌های آتی و تسهیل دسترسی روی دسکتاپ دستگاه اندرویدی قرار دهید.

 

در نرم افزار Expo روی آیکون Explore کلیک نمائید.

 

 

 

آیکون کاوش را زده و عبارت exp://localhost:19000 را وارد فرمایید و یا این که میتوانید URL-ی را که از سوی yarn android ارائه گردیده است را وارد فرمائید.

 

 

 

روی عبارت Tap to attempt to open project at exp://localhost:19000 کلیک فرمائید. فعلا می بایست نرم افزار React Native خویش را ببینید. پوشه‌های پروژه را در ویرایشگر متنی متبوع خویش دستکاری فرمائید تا از قابلیت لود دوباره آنی فایده‌مند گردید.

 

صحبت آخری

شما میتوانید مشابه‌ساز را پین نمایید تا همواره فراتر از پنجره‌های دیگر ظواهر گردد. به این مراد در پیکربندی مشابه‌ساز (به عبارتی منوی سه‌نقطه در سمت راست پنجره) روی برگه Settings کلیک فرمائید. در صفحه General، سوئیچ Emulator always on top را فعال فرمائید. براین اساس به نقطه پایان این نوشته‌ی علمی می‌رسیم و امید داریم در انتهای تفحص آن، با شیوه اجرای نرم افزار‌های React Native روی «مشابه‌ساز اندروید» (Android Emulator) آشنا گردیده باشید و تنظیمات‌های مختلفی که به‌این مراد ما یحتاج میباشند را بشناسید.

 

 

مقداردهی اول با تأخیر (lazy Initialization)

مقداردهی با تأخیر (by lazy) در مواقعی که سرگرم پیاده‌سازی مشخصه‌های تنها-خواندنی هستیم که به طور با تأخیر در کاتلین ایفا میگردند موثر خواهد بود. by lazy { … } مقداردهی اول خویش را جایی اعمال میدهد که مشخصه نخستین دفعه استعمال می شود و خیر در طول طراحی اپلیکیشن در مشهد  اعلان کردن آن.

 

class Demo { val myName: String by lazy { "John" } }

 

مقداردهی نماید

مقداردهی نماید متغیرها به‌این معنا میباشد که بسط‌دهندگان پیش از دسترسی به متغیر آن را جایی در کد مقداردهی نخستین می‌نمایند.

 

class Demo { val myName: String by lazy { "John" } }

کلاس داده

ما به صورت مکرر کلاس‌هایی میسازیم که کاری به جز محافظت داده‌ها ندارند. در اینگونه کلاس‌هایی بعضا کارکردهای استاندارد غالباً به طور مکانیکی از داده‌ها مشتق میشوند. در کاتلین، این فعالیت در کلاس داده انجام می گردد و به طور داده‌ای نشانه‌گذاری می گردد.

 

data class Developer(val name: String, val age: Int)

هنگامی که یک کلاس به طور کلاس داده نشانه‌گذاری خواهد شد، نیاز وجود ندارد که تابع‌های پایین را مانند جاوا در آن پیاده‌سازی یا این که ساخت کنیم:

 

()hashCode

()equals

()toString

()copy

کامپایلر به طور اتوماتیک این مفاد را به طور داخلی ساخت می‌نماید و به این ترتیب کد تمیزتری خوا هیم داشت.

 

کلاس‌های مهر و موم گردیده

کلاس‌های مهر و موم گردیده برای اکران سلسله مراتب کلاس محدودشده به کارگیری می شوند که در آنان شیء یا این که مقدار صرفا یک نوع می تواند داشته باشد و از این رو با نوع ثابتی در سلسله مراتب مواجه هستیم. کلاس‌های مهر و موم گردیده به صورت مکرر در مورد ها مختلفی که می دانیم مقدار مفروضی دارنده فقطً مورد‌های محدودی میباشد، به کارگیری میشوند.

 

1sealed class Operation {

2 class Add(val value: Int) : Operation()

3 class Substract(val value: Int) : Operation()

4 class Multiply(val value: Int) : Operation()

5 class Divide(val value: Int) : Operation()

6 }

 

تابع‌های اکستنشن

تابع‌های اکستنشن در کاتلین به ما قابلیت و امکان می دهند که کارکرد یک کلاس را با اضافه کردن امکان‌های نو توسعه دهیم. این کلاس لزوماً نباید به ما وابستگی داشته باشد، بلکه میتواند کتابخانه فرد ثالث باشد و همینطور الزامی به ارث‌بری از کلاس نیست.

 

1fun Int.triple(): Int {

2 return this * 3

3 }

 

براین اساس به انتهای این نوشته‌علمی می‌رسیم و امید خواهیم داشت از آن سود کافی را برده باشید.

 

 

نوتیفیکیشن اندروید – اصول مقدماتی

استارت

برای شروع بایستی آغاز «فایربیس» (Firebase) را در نرم افزار خویش فعال‌سازی کنیم. بدین خواسته پیش از هر چیز می بایست یک پروژه در کنسول فایربیس (+) تولید کنیم. دقت داشته باشید که در حین کتابت این نوشته‌ی‌علمی، کشور‌ایران در فهرست کشورهای تحریم گردیده از سوی این خدمت قراردارد و برای دسترسی به آن بایستی از ابزارهای کمکی قابل قبولی استعمال نمایید.

 

 

کلیک نمایید

بعداز اجرای این مرحله قادر خواهیم بود نرم افزار خویش را به پروژه اضافه کنیم. به‌این خواسته روی پروژه خویش کلیک کرده و بعد روی دکمه + Add app کلیک کرده و درپی روی آیکون اندروید بزنید. در غایت می بایست برخی داده ها مقدماتی در ارتباط نرم افزار خویش وارد فرمائید و پوشه تنظیمات google-services.json را که برای اتصال نرم افزار به فایربیس ضروری میباشد را دانلود نمائید. در این زمینه درپی بیشتر توضیح خوا هیم بخشید. موقتاً همین امور در کنسول فایربیس کافی میباشد.

 

اتصال نرم افزار به فایربیس

فعلا به نصیب دیدنی داستان می‌رسیم. در پروژه اندروید پوشه build.gradle پروژه را گشوده نمائید. باور پیدا فرمایید که ریپازیتوری maven گوگل را در هر دو بلوک repositories و همینطور بلوک allprojects اضافه کرده‌اید و در ضمنً پلاگین Google Services را در تعلق‌ها به طور ذیل قرار داده‌اید:

 

1buildscript {

2 repositories {

3 google()

4 // ... Your other repo's go here

5 }

6

7 dependencies {

8 // ... Your other dependencies

9 classpath 'com.google.gms:google-services:4.2.0'

10 }

11}

12

13allprojects {

14 // ...

15

16 repositories {

17 google()

18 // ... Your other repo's go here

19 }

20}

مشاهده بی نقص کدها

پیرو به پوشه build.gradle نرم افزار راز می زنیم. همینطور تعلق Firebase Core را به پروژه اضافه کرده و پلاگین Google Services را در انتهای پوشه اضافه می کنیم:

 

1dependencies {

2 // ... Put your other dependencies here

3

4 implementation 'com.google.firebase:firebase-core:16.0.9'

5}

6

7apply plugin: 'com.google.gms.google-services' // Make sure you apply the plugin at the bottom of the file

 

عمل به طور تقریبً به نقطه پايان رسیده میباشد. به خیال و خاطر دارید که در مرحله پیشین پوشه تنظیمات google-services.json را از کنسول فایربیس دانلود کردیم. در حال حاضر بایستی این پوشه را در دایرکتوری app اضافه کنیم تا شغل تنظیمات فایربیس در نرم افزار به پایان برسد.

 

ارسال پیام

فعلا که نرم افزار خویش را به پروژه فایربیس اضافه کردیم، مهیا هستیم تا از خدمت پیام‌رسانی ابری خویش منفعت بگیریم. FCM که اختصاری برای «پیام‌رسانی ابری فایربیس» (Firebase Cloud Messaging) میباشد، استاندارد جدیدی برای نوتیفیکیشن به حساب می آید، زیرا گوگل مدد از GCM را متوقف کرده و آن را منسوخ کرده است. به این مراد کافی میباشد تعلق را به پوشه build.gradle نرم افزار اضافه کنیم:

 

1implementation 'com.google.firebase:firebase-messaging:18.0.0'

 

در شرایطی‌که میخواهید روی مدیر نوتیفیکیشن‌ها در پیش‌قضیه در اختیار گرفتن بیشتری داشته باشد، داده‌ها را باطن نوتیفیکیشن رئیس نمائید و یا این که میخواهید دستگاه‌های منفرد خاص یا این که دسته‌های معینی از اشخاص را هنگام ارسال نوتیفیکیشن مقصود‌گیری فرمائید، در این‌حالت به سرویسی نیاز دارید که FirebaseMessagingService را توسعه و گسترش دهد. ما آن را MessagingService.kt می‌نامیم:

 

1class MessagingService : FirebaseMessagingService() {

2

3 override fun onNewToken(token: String) {

4 // Sync your token with the backend here (optional)

5 }

6

7 override fun onMessageReceived(remoteMessage: RemoteMessage?) {

8 // Handle the incoming message here

9 }

10}

 

این دقیقاً به عبارتی جایی میباشد که یک پیام ورودی یا این که احتمالاً رفرش/ساخت توکن را رئیس می کنید. بنابراین می‌قدرت یک توکن را برای مثال در فراخوانی onNewToken به بک‌اند فرستاد و روی آن کارهایی اجرا بخشید یا این که یک نوتیفیکیشن در onMessageReceived تشکیل داد. به حافظه بسپارید که نیازی به ایجاد کرد یک نوتیفیکیشن برای اکران دادن نیست. این مورد را پیرو بیشتر توضیح می دهیم.

 

اینک که MessagingService خویش را ساخته‌ایم، بایستی آن را در مانیفست نیز تصویب کنیم:

 

1

2 3 android:name=".MessagingService"

4 android:exported="false">

5

6

7

8

 

اکنون حاذق هستیم نوتیفیکیشن ورودی خویش را از روش خدمت پیام‌رسانی خودمان مدیر کنیم.

 

 

تزریق تعلق در Koin – به لهجه معمولی

فرض نمائید دو کلاس به اسم‌های A و B داریم که کلاس A با استعمال از متدی در کلاس B به آن اشاره می‌نماید. این عملیات مستقیماً یک تعلق میان دو کلاس ساخت و ساز می‌نماید، زیرا قبل از آماده داخل شدن قابلیت استعمال از سیاق یک کلاس در کلاس‌های دیگر مورد نیاز میباشد که دفعه‌ای از آن کلاس ساخت‌و‌ساز گردد. در این باره مورد نیاز میباشد که کلاس A دفعه‌ای از کلاس B را قبل از دسترسی به متدهای آن تولید کرده‌با‌شد. در یک پروژه بی آلایش، دفعه‌سازی از شی ها کاری میباشد که می‌قدرت به طور دستی اعمال بخشید، ولی در بعضا موردها ما یحتاج میباشد که شی ها به طور خود کار با به کار گیری از برای مثالً یک فریمورک نوبت‌سازی شوند. به این ترتیب جابجایی وظیفه ساخت‌و‌ساز یک شیء به شخص دیگر و به کار گیری بدون واسطه از تعلق به عبارتی تزریق تعلق طراحی اپلیکیشن در مشهد  نامیده می گردد.

به کار گیری از تزریق تعلق چه اهمیتی دارااست؟

اصل پنجم S.O.L.I.D ذکر می‌نماید که یک کلاس می بایست به تجرید متعلق باشد و خیر کد طاقت فرسا. S.O.L.I.D مشتمل بر پنج اصل نرم افزار‌نویسی شیءگرا میباشد که از سوی Uncle Bob پیاده سازی گردیده است. مفهوم گفته فوق این میباشد که یک کلاس، نباید تعلق‌های خویش را به طور استاتیک تنظیمات نماید؛ بلکه می بایست آنها را توسط کلاس‌هایی از فارغ خویش تنظیمات نماید.

 

با به کار گیری از این اصول، کد شما می تواند به طریق بی آلایش‌ای آزمایش خواهد شد و وراثت در میان کلاس‌های گوناگون آسوده‌خیس می‌گردد و کامپوننت‌های نرم افزار «وصلت سست» (loose coupling) خواهند داشت که در نرم افزار‌نویسی نرم افزار نکته مهمی به حساب می آید.

 

Koin چیست؟

Koin (+) یک فریمورک تزریق تعلق اپلیکیشن‌نویسی گردیده مدل برای توسعه و گسترش‌دهندگان کاتلین میباشد که مسئولیت نوبت‌سازی اشیای متعدد را در نرم افزار بر ذمه میگیرد.

 

 

کلیک فرمایید

به کار گیری از Koin در پروژه‌های اندروید

برای فهم بدون نقص طریق به کارگیری از Koin یک نرم افزار خرد اندرویدی میسازیم که فهرستی از یوزرها گیت‌هاب را که در‌این نشانی (+) جانور میباشد اکران میدهد.

 

معماری نرم افزار ما به طور تصویر پایین خواهد بود. ما قصد نداریم از مقر داده SQLite استعمال کنیم و نرم افزار مستقیماً با داده‌هایی که از خدمت اینترنت میاید، فارغ از این که آنان‌را در مقر داده محلی ذخیره نماید، تعامل خواهد کرد.

 

 

 

چنانچه به تصویر فوق اعتنا نمائید، می بینید که Activity مستقیماً با View-model تعامل می یابد که آن نیز به نوبه خویش مستقیماً با Repository تعامل داراست که مسئول گزینش منبع داده میباشد. در ارتباط این نمونه ریپازیتوری فقط یک منبع داراست.

 

چنان که در تصویر فوق می بینید، کامپوننت‌های مهم نرم افزار ما به همپا تعلق‌های بینشان معین گردیده‌اند. Activity یک ارجاع به ViewModel داراست و آن نیز به نوبه خویش ارجاعی به Repository داراست که از retrofit برای بازیابی داده‌ها از سرور به کارگیری می‌نماید. در طی این راهنما با نحوه مدیر مؤثر این تعلق‌ها از سوی Koin آشنا خوا‌هیم شد.

 

قدم 1: اضافه کردن تعلق‌های ما یحتاج در پوشه gradle

فولدر build.gradle

 

1// Retrofit

2implementation 'com.squareup.retrofit2:retrofit:2.6.0'

3implementation 'com.squareup.retrofit2:converter-gson:2.6.0'

4

5// We will use it for loading the images

6implementation 'com.squareup.picasso:picasso:2.71828'

7

8// For ViewModel

9implementation "androidx.lifecycle:lifecycle-extensions:2.0.0"

10implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.0.0"

11

12// Koin

13implementation "org.koin:koin-android:2.0.1"

14implementation 'org.koin:koin-androidx-viewmodel:2.0.1'

15implementation 'org.koin:koin-androidx-scope:2.0.1'

مشاهده بدون نقص کدها

قدم 2: ساخت کلاسی که مخاطب را روی گیت‌هاب اکران می دهد

به خواسته آسانی نرم افزار، فقط سه گزینه از داده ها استفاده کننده یعنی id، اسم کاربری و تصویر او‌را ذخیره میکنیم:

 

پوشه User.kt

 

1data class GithubUser(

2 val id: Long,

3 val login: String,

4 val avatar_url: String

5)

 

قدم 3: ساخت و ساز کامپوننت‌های نرم افزار

اینترفیسی که اینترنت‌خدمت را اکران می دهد:

 

فولدر GithubApi.kt

 

1interface GithubApi {

2

3 @GET("users")

4 fun getUsers(): Call>

5}

 

کلاس ریپازیتوری به طور پایین میباشد. یک پارامتر به اسم GithubApi داراست.

 

پوشه UserRepository.kt

 

1class UserRepository(private val api: GithubApi) {

2 fun getAllUsers() = api.getUsers()

3}

 

سبک نما یک نوبت از UserRepository را تحت عنوان پارامتر میگیرد:

 

پوشه UserViewModel.kt

 

1class UserViewModel(private val repo: UserRepository) : ViewModel(), Callback> {

2

3 private val _loadingState = MutableLiveData()

4 val loadingState: LiveData

5 get() = _loadingState

6

7 private val _data = MutableLiveData>()

8 val data: LiveData>

9 get() = _data

10

11 init {

12 fetchData()

13 }

14

15 private fun fetchData() {

16 _loadingState.postValue(LoadingState.LOADING)

17 repo.getAllUsers().enqueue(this)

18 }

19

20 override fun onFailure(call: Call>, t: Throwable) {

21 _loadingState.postValue(LoadingState.error(t.message))

22 }

23

24 override fun onResponse(call: Call>, response: Response>) {

25 if (response.isSuccessful) {

26 _data.postValue(response.body())

27 _loadingState.postValue(LoadingState.LOADED)

28 } else {

29 _loadingState.postValue(LoadingState.error(response.errorBody().toString()))

30 }

31 }

32}

مشاهده بی نقص کدها

نکته: ما از کلاس کمکی به کار گیری کردیم تا بتوانیم موقعیت بار گذاری را رئیس کنیم.

 

فولدر LoadingState.kt

 

1data class LoadingState private constructor(val status: Status, val msg: String? = null) {

2 companion object {

3 val LOADED = LoadingState(Status.SUCCESS)

4 val LOADING = LoadingState(Status.RUNNING)

5 fun error(msg: String?) = LoadingState(Status.FAILED, msg)

6 }

7

8 enum class Status {

9 RUNNING,

10 SUCCESS,

11 FAILED

12 }

13}

 

 

تشکیل داد نرم افزار یادداشت با فلاتر و دارت – از صفر تا صد

فلاتر یک فریمورک توسعه و گسترش تلفن همراه چندپلتفرمی اوپن سورس میباشد که از سوی گوگل عرضه گردیده‌است. نرم افزار‌ها‌ی فلاتر با دارت نوشته می گردند. فلاتر به طور پیش‌فرض مجهز به کامپوننت‌های «متریال طراحی صفحه» (Material Design) میباشد و همین فرمان موجب گردیده‌است تا تشکیل داد نرم افزار با ظواهر و شم عالی با به کارگیری از فلاتر بسیار آسوده باشد. در فلاتر هر چیزی یک ویجت از نوع باحالت یا این که بی‌شرایط به حساب می آید. در‌این راهنما تحت عنوان یک پروژه برای استارت یادگیری فلاتر، ‌مبادرت به تشکیل داد نرم افزار یادداشت با فلاتر و دارت خوا هیم کرد.

درصورتی که هنوز فلاتر را روی سیستم خویش نصب نکرده‌اید، آن را به یار یک طراحی اپلیکیشن در مشهد  IDE جانبداری‌گردیده نصب نمایید. ارشادوراهنمایی‌های مایحتاج درین کاغذ (+) انجام شده میباشد.

 

آغاز پروژه را تهیه می کنیم. فرایند عمل به طور ذیل میباشد:

 

یک پروژه فلاتر در اندروید استودیو ساخت و ساز نمایید یا این که فرمان flutter create notes را در ترمینال یا این که CMD وارد نمائید.

در فولدر main.dart کلاس homepage را حذف کرده و یک فولدر نو با کلاس homepage خودتان ساخت فرمائید که Stateful Widget را توسعه و گسترش دهد. این کلاس مشتمل بر چارچوب کلی نرم افزار ما خواهد بود.

کلاس ویجت باحالت دیگری ساخت نمایید. این کلاس مشتمل بر نصیب Body میباشد که یک نمای Staggered را برای Home در خویش مکان داده میباشد. اسم آن را StaggeredGridPage میگذاریم.

 

کلیک نمایید

درین نرم افزار کوشش می کنیم که اختراع به خرج بدهیم و یادداشت‌ها را به نحوه Staggered جالبی اکران دهیم. از این پکیج دارت برای (+) ‌ساخت و ساز نمای کانال‌ای Staggered استعمال می کنیم. از SQLite نیز برای ذخیره داده‌های یادداشت‌ها روی دستگاه به کارگیری می کنیم.

 

در‌پی قطعه کدی را از pubspec.yaml می بینید که تعلق‌های فهرست گردیده را الزام نموده است. آنان‌را اضافه کرده، فولدر را ذخیره نمائید و از فرمان فلاتر flutter packages get برای نصب تعلق‌های اضافه گردیده تازه استعمال نمایید.

 

1dependencies:

2 flutter:

3 sdk: flutter

4

5 cupertino_icons: ^0.1.2

6 flutter_staggered_grid_view: ^0.2.7

7 auto_size_text: ^1.1.2

8 sqflite:

9 path:

10 intl: ^0.15.7

11 share: ^0.6.1

 

یک کلاس برای یادداشت‌ها ساخت‌و‌ساز نمائید. ما به تابع toMap برای کوئری‌های مقر داده نیاز داریم.

 

فولدر note.dart

1class Note {

2 int id;

3 String title;

4 String content;

5 DateTime date_created;

6 DateTime date_last_edited;

7 Color note_color;

8 int is_archived = 0;

9

10 Note(this.id, this.title, this.content, this.date_created, this.date_last_edited,this.note_color);

11

12 Map toMap(bool forUpdate) {

13 var data = {

14// 'id': id, since id is auto incremented in the database we don't need to send it to the insert query.

15 'title': utf8.encode(title),

16 'content': utf8.encode( content ),

17 'date_created': epochFromDate( date_created ),

18 'date_last_edited': epochFromDate( date_last_edited ),

19 'note_color': note_color.value,

20 'is_archived': is_archived // for later use for integrating archiving

21 };

22 if(forUpdate){ data["id"] = this.id; }

23 return data;

24 }

25

26// Converting the date time object into int representing seconds passed after midnight 1st Jan, 1970 UTC

27int epochFromDate(DateTime dt) { return dt.millisecondsSinceEpoch ~/ 1000; }

28

29void archiveThisNote(){ is_archived = 1; }

30}

مشاهده بی نقص کدها

کد کوئری‌های مقر داده SQLite برای کلاس note فوق و جدول مربوطه به طور پایین میباشد:

 

فولدر SqliteHandler.dart

1import 'package:sqflite/sqflite.dart';

2import 'package:path/path.dart';

3import 'package:sqflite/sqlite_api.dart';

4import 'dart:async';

5import 'Note.dart';

6

7class NotesDBHandler {

8

9 final databaseName = "notes.db";

10 final tableName = "notes";

11

12

13 final fieldMap = {

14 "id": "INTEGER PRIMARY KEY AUTOINCREMENT",

15 "title": "BLOB",

16 "content": "BLOB",

17 "date_created": "INTEGER",

18 "date_last_edited": "INTEGER",

19 "note_color": "INTEGER",

20 "is_archived": "INTEGER"

21 };

22

23

24 static Database _database;

25

26

27 Future get database async {

28 if (_database != null)

29 return _database;

30

31 _database = await initDB();

32 return _database;

33 }

34

35

36 initDB() async {

37 var path = await getDatabasesPath();

38 var dbPath = join(path, 'notes.db');

39 // ignore: argument_type_not_assignable

40 Database dbConnection = await openDatabase(

41 dbPath, version: 1, onCreate: (Database db, int version) async {

42 print("executing create query from onCreate callback");

43 await db.execute(_buildCreateQuery());

44 });

45

46 await dbConnection.execute(_buildCreateQuery());

47 _buildCreateQuery();

48 return dbConnection;

49 }

50

51

52// build the create query dynamically using the column:field dictionary.

53 String _buildCreateQuery() {

54 String query = "CREATE TABLE IF NOT EXISTS ";

55 query += tableName;

56 query += "(";

57 fieldMap.forEach((column, field){

58 print("$column : $field");

59 query += "$column $field,";

60 });

61

62

63 query = query.substring(0, query.length-1);

64 query += " )";

65

66 return query;

67

68 }

69

70 static Future dbPath() async {

71 String path = await getDatabasesPath();

72 return path;

73 }

74

75 Future insertNote(Note note, bool isNew) async {

76 // Get a reference to the database

77 final Database db = await database;

78 print("insert called");

79

80 // Insert the Notes into the correct table.

81 await db.insert('notes',

82 isNew ? note.toMap(false) : note.toMap(true),

83 conflictAlgorithm: ConflictAlgorithm.replace,

84 );

85

86 if (isNew) {

87 // get latest note which isn't archived, limit by 1

88 var one = await db.query("notes", orderBy: "date_last_edited desc",

89 where: "is_archived = ?",

90 whereArgs: [0],

91 limit: 1);

92 int latestId = one.first["id"] as int;

93 return latestId;

94 }

95 return note.id;

96 }

97

98

99 Future copyNote(Note note) async {

100 final Database db = await database;

101 try {

102 await db.insert("notes",note.toMap(false), conflictAlgorithm: ConflictAlgorithm.replace);

103 } catch(Error) {

104 print(Error);

105 return false;

106 }

107 return true;

108 }

109

110

111 Future archiveNote(Note note) async {

112 if (note.id != -1) {

113 final Database db = await database;

114

115 int idToUpdate = note.id;

116

117 db.update("notes", note.toMap(true), where: "id = ?",

118 whereArgs: [idToUpdate]);

119 }

120 }

121

122 Future deleteNote(Note note) async {

123 if(note.id != -1) {

124 final Database db = await database;

125 try {

126 await db.delete("notes",where: "id = ?",whereArgs: [note.id]);

127 return true;

128 } catch (Error){

129 print("Error deleting ${note.id}: ${Error.toString()}");

130 return false;

131 }

132 }

133 }

134

135

136 Future>> selectAllNotes() async {

137 final Database db = await database;

138 // query all the notes sorted by last edited

139 var data = await db.query("notes", orderBy: "date_last_edited desc",

140 where: "is_archived = ?",

141 whereArgs: [0]);

142

143 return data;

144

145 }

146

147

148

149}

مشاهده بدون نقص کدها

فعلا کاغذ مهم نرم افزار متریال بایستی یک چارچوب (Scaffold) از پوشه HomePage.dart داشته باشد که بدنه آن به طور StaggeredGridView میباشد. در قسمت AppBar این چارچوب یک دکمه اکشن قرار میدهیم تا استفاده کننده بتواند در میان موقعیت‌های اکران لیستی و Staggered تعیین نماید. فراموش نکنید که Body را داخل SafeArea قرار دهید، زیرا میخواهیم نرم افزار روی موبایل‌های امروزی نیز تلاش قابل قبولی داشته باشد.

 

کتابخانه نمای Staggered یک‌سری یادداشت برای نما الزام می‌نماید که به طور دینامیک بر مبنای پهنا اندازه شیت اکران انتخاب میگردد. این حالت مستلزم این میباشد که تعداد یادداشت‌هایی که قرار میباشد در کنار هم اکران یابند، معلوم گردیده باشد. در حالت افقی موبایل یا این که روی تبلت، تعداد یادداشت‌ها را به طور افقی روی 3 عدد و برای شرایط عمودی روی موبایل روی عدد 2 تهیه میکنیم.

 

پوشه StaggeredView.dart

1import 'dart:convert';

2import 'package:flutter/material.dart';

3import 'package:flutter_staggered_grid_view/flutter_staggered_grid_view.dart';

4import '../Models/Note.dart';

5import '../Models/SqliteHandler.dart';

6import '../Models/Utility.dart';

7import '../Views/StaggeredTiles.dart';

8import 'HomePage.dart';

9

10class StaggeredGridPage extends StatefulWidget {

11 final notesViewType;

12 const StaggeredGridPage({Key key, this.notesViewType}) : super(key: key);

13 @override

14 _StaggeredGridPageState createState() => _StaggeredGridPageState();

15}

16

17class _StaggeredGridPageState extends State {

18

19 var noteDB = NotesDBHandler();

20 List> _allNotesInQueryResult = [];

21 viewType notesViewType ;

22

23@override

24 void initState() {

25 super.initState();

26 this.notesViewType = widget.notesViewType;

27 }

28

29@override void setState(fn) {

30 super.setState(fn);

31 this.notesViewType = widget.notesViewType;

32 }

33

34 @override

35 Widget build(BuildContext context) {

36 GlobalKey _stagKey = GlobalKey();

37 if(CentralStation.updateNeeded) { retrieveAllNotesFromDatabase(); }

38 return Container(child: Padding(padding: _paddingForView(context) , child:

39 new StaggeredGridView.count(key: _stagKey,

40 crossAxisSpacing: 6, mainAxisSpacing: 6,

41 crossAxisCount: _colForStaggeredView(context),

42 children: List.generate(_allNotesInQueryResult.length, (i){ return _tileGenerator(i); }),

43 staggeredTiles: _tilesForView() ,

44 ),

45 )

46 );

47 }

48

49 int _colForStaggeredView(BuildContext context) {

50 if (widget.notesViewType == viewType.List) { return 1; }

51 // for width larger than 600, return 3 irrelevant of the orientation to accommodate more notes horizontally

52 return MediaQuery.of(context).size.width > 600 ? 3 : 2 ;

53 }

54

55 List _tilesForView() { // Generate staggered tiles for the view based on the current preference.

56 return List.generate(_allNotesInQueryResult.length,(index){ return StaggeredTile.fit( 1 ); }

57 ) ;

58}

59

60EdgeInsets _paddingForView(BuildContext context){

61 double width = MediaQuery.of(context).size.width;

62 double padding ;

63 double top_bottom = 8;

64 if (width > 500) {

65 padding = ( width ) * 0.05 ; // 5% padding of width on both side

66 } else {

67 padding = 8;

68 }

69 return EdgeInsets.only(left: padding, right: padding, top: top_bottom, bottom: top_bottom);

70}

71

72

73 MyStaggeredTile _tileGenerator(int i){

74 return MyStaggeredTile( Note(

75 _allNotesInQueryResult[i]["id"],

76 _allNotesInQueryResult[i]["title"] == null ? "" : utf8.decode(_allNotesInQueryResult[i]["title"]),

77 _allNotesInQueryResult[i]["content"] == null ? "" : utf8.decode(_allNotesInQueryResult[i]["content"]),

78 DateTime.fromMillisecondsSinceEpoch(_allNotesInQueryResult[i]["date_created"] * 1000),

79 DateTime.fromMillisecondsSinceEpoch(_allNotesInQueryResult[i]["date_last_edited"] * 1000),

80 Color(_allNotesInQueryResult[i]["note_color"] ))

81 );

82 }

83

84 void retrieveAllNotesFromDatabase() {

85 // queries for all the notes from the database ordered by latest edited note. excludes archived notes.

86 var _testData = noteDB.testSelect();

87 _testData.then((value){

88 setState(() {

89 this._allNotesInQueryResult = value;

90 CentralStation.updateNeeded = false;

91 });

92 });

93 }

94}

مشاهده بدون نقص کدها

این نما به کاشی‌هایی (Tiles) برای اکران یادداشت‌ها نیاز دارااست. آن کاشی که ما برای نما پیاده سازی می کنیم بایستی تیتر و محتوای یادداشت را به طور پیش‌اکران ارائه نماید. برای مدیر ارتفاع متعدد متن یادداشت از یک کتابخانه (+) ‌جهت ساخت و ساز نمای متنی با پیشرفت خود کار به کارگیری می کنیم. کافی میباشد محدودیت خط را تعریف‌و‌تمجید کنیم تا ویجت به طور اتوماتیک توسعه یابد و محتوا را تا جایی که بدین محدودیت می رسد، اکران دهد.

 

همچون segue در iOS و Intent در اندروید، برای ناوبری میان ورقه‌ها در فلاتر از Navigator استعمال میکنیم.