یک نکتهی تکمیلی
بله. یک فایل متنی ساده است. برای تغییر آن مطلب «بررسی مقدمات کتابخانهی JSON.NET» را مطالعه کنید.
خلاصه نکات این مطلب توسط IHttpRequestInfoService به کتابخانهی DNTCommon.Web.Core اضافه شدند.
PM> Install-Package DNTCommon.Web.Core
کتابخانهی دیگری برای فشرده سازی و یکی کردن در زمان اجرا:
WebOptimizer - a Bundler and Minifier for ASP.NET Core
WebOptimizer - a Bundler and Minifier for ASP.NET Core
نظرات مطالب
متدی برای بررسی صحت کد ملی وارد شده
جهت اطلاع
متد IsValidIranianNationalCode به کتابخانهی DNTPersianUtils.Core اضافه شد با این آزمونهای واحد.
متد IsValidIranianNationalCode به کتابخانهی DNTPersianUtils.Core اضافه شد با این آزمونهای واحد.
نیازی به Wait در اینجا ندارید چون این Wait در خود کتابخانهی اصلی انجام میشود. به عبارتی محتوای MainAsync را به RunAsync منتقل کنید، کافی است.
بله. نسخهی 4 آن هنوز نهایی نشدهاست: «نگاهی به وضعیت کتابخانهی Lucene.NET »
Apache Cordova یک فریمورک سورس باز برای ساخت اپلیکیشنهای چند سکویی موبایل (cross platform) با استفاده از Html5 میباشد.
طی چند مقاله، با استفاده کردن از این فریمورک در VS آشنا خوهیم شد.
هدف خالقان Cordova یافتن یک راه ساده برای تولید اپلیکیشنهای چند سکویی موبایل بود که برای رسیدن به این هدف تصمیم گرفتند از تکنولوژیهای بومی (native) و تکنولوژیهای وب استفاده کنند. به این نوع از اپلیکیشنهای موبایل، Hybrid Application میگویند.
Cordova دارای قابلیتهای بومی بالایی است و مهمتر اینکه به طور طبیعی توسط مرورگرها پشتیبانی میشود. بعد از تولد Corodva، این فریمورک تبدیل شده است به بهترین روش تولید اپلیکیشنهایی که بر روی چند نوع پلتفرم کار میکنند.
پیشتر محدودیتی که وجود داشت شامل این بود که اپلیکیشنهای موبایل، به چیزهایی بیشتر از HTML و مرورگرهای وب، نیاز داشتند. برخی از این نیازها عبارتند از ارتباط متقابل وب اپلیکیشنها با دوربین یا لیست شمارههای تماس گوشی که برطرف کردن آن هم به راحتی امکان پذیر نبود.
Cordova برای مقابله با این محدودیت، مجموعهای از رابطهای برنامه کاربردی را برای توسعه قابلیتهای بومی device، مانند لیست مخاطبین، دوربین، تشخیص دهندهی تغییر جهت گوشی (accelerometer) و مانند این موارد، در نظر گرفته است.
Cordova شامل یک سری کامپوننت به شرح زیر است:
- سورس کدی برای هر Container و برنامه محلی برای هر یک از سکوهای موبایل که پشتیبانی میشوند. container، کدهای Html5 را بر روی دستگاه (Device) رندر میکند. (در مطالب بعدی در مورد این مطلب توضیح خواهم داد)
- مجموعهای از رابطهای برنامهی کاربردی که امکان دسترسی به قابلیتهای بومی دستگاه را به برنامهی وبی که درون آن در حال اجرا است، میدهند.
- مجموعهای از ابزارها برای مدیریت فرآیند ایجاد پروژه، مدیریت پلاگینها، ساخت (با استفاده از SDKهای محلی) برنامههای محلی و تست برنامه بر روی دستگاه موبایل یا شبیه ساز .
برای ساخت یک برنامهی Cordova، در واقع شما یک وب اپلیکیشن میسازید و آن را داخل Container محلی، بسته بندی میکنید. سپس تست کرده و بعد از دیباگ میتوانید اپلیکیشن را توزیع کنید.
فرآیند بسته بندی :
داخل اپلیکیشن محلی، رابط کاربری اپلیکیشن شامل یک صفحهی نمایش که خود آن چیزی نیست به غیر از یک Web View که از فضای نمایش دستگاه استفاده میکند. زمانی که برنامه آغاز به کار میکند، برنامهی وب نوشته شده، درون این web view لود میشود و کنترلهای موجود، برای تعامل کاربر با برنامهی وب، در اختیار آن قرار میگیرند. مانند تعامل کاربر با محتوا، در برنامهها ی تحت وب، لینکها، کدهای نوشته شدهی js در فایلها و یا حتی میتواند به اینترنت دسترسی داشته باشد و محتوا را از یک وب سرور تغذیه کند.
درباره Web Views
Web View جزء برنامههای بومی است که برای رندر کردن محتوای وب (به عنوان نمونه صفحه HTML) درون اپلیکیشن بومی یا صفحه نمایش استفاده میشود. در اصل Web View یک Wrapper برنامه نویسی شده قابل دسترس برای نمایش محتوای صفحات وب توکار است.
به عنوان مثال:
در اندروید با استفاده از WebView موجود در (Using andoid.webkit.WebView) , در iOS با UIWebView موجود در (Using System/Library/Framworks/UIKit.framewor) به این هدف دست پیدا میکنند. وب اپلیکیشن ما درون این Container مانند سایر وب اپلیکیشنهایی است که هر روز با آنها سرو کار دارید و آنها را در مرورگر موبایل خود اجرا میکنید و میتوانید بین صفحات Navigation داشته باشید. وب اپلیکیشنهای معمول باید روی یک سرور هاست شوند. در برنامه نویسی چند سکویی با Cordova، این کار میتواند درون Cordova Application انجام گیرد.
شاید سؤالی در ذهن شما وجود داشته باشد که مرورگر معمولا به اپلیکیشنهای موجود در دستگاه، سخت افزار و یا APIهای بومی دستگاه، دسترسی ندارد. برای مثال شاید بگویید که یک وب اپلیکیشن معمولا به لیست مخاطبین با دوربین دستگاه و ... دسترسی ندارد.
جواب : در واقع امکان دسترسی به این قابلیتها توسط اپلیکیشن بومی (native mobile application) ایجاد میشود.
Cordova مجموعه ای از APIهای جاوااسکریپت را به عنوان اهرم اجازه برای دسترسی برنامه وب درون cordova container به قابلیتهای بومی دستگاه، در اختیار توسعه دهندگان قرار داده است.
این APIها در دو بخش پیاده سازی میشوند:
1-کتابخانهی جاوااسکریپت که اجازهی استفاده از قابلیتهای بومی را به وب اپلیکیشن میدهد و کد بومی مشابه در Container اجرا میشود که مربوط است به بخش بومی این API ها. در اصل یک کتابخانهی جاوا اسکریپت وجود دارد، اما بخش بومی APIها وابسته به سکوی (platform) انتخاب شده پیاده سازی میشود.
اگر شما از APIهای موجود استفاده نکنید، میتوانید آنها را از کتابخانه جاوااسکریپت و native container حذف کنید. این کار به صورت دستی شاید خوشایند نباشد ولی چون در Cordova 3.0 همهی API ها از بیرون وارد میشوند، میتوانید با استفاده از بحث مدیریت پلاگین آن، پلاگینها را اضافه یا حذف کنید. در بخشهای بعد با مثالهایی عملی این مباحث را کار خواهیم کرد.
ادامه دارد..
در قسمت قبلی با تبهای فایرباگ آشنا شدیم . در این قسمت و قسمتهای بعدی ، با هر تب به صورت کامل آشنا خواهیم شد .
در این قسمت با تب Console آشنا خواهیم شد .
در قسمت قبل در مورد این تب گفتیم :
در این تب دو بخش وجود دارد :
در بخش Log هشدارها ، پیغامها ، درخواستهای XHR و ... نمایش داده میشوند .
بخش دیگر هم که در سمت راست قرار دارد ، مخصوص اجرای کدهای جاوا اسکریپت میباشد .
پس یک قسمت داریم برای نوشتن کدهای جاوا اسکریپت و یک قسمت هم برای مشاهدهی رویدادها .
اکنون 2 سوال مطرح میشود :
همین 2 سوال اهمیت و قدرت فایرباگ و قسمت Console آن را برای ما آشکار میکند ، زیرا ما میتوانیم بدون Reload کردن صفحه ، کدهایمان را اجرا و نتیجه را مشاهده کنیم یا بوسیله توابع موجود خیلی ساده کدهایمان را خطایابی کنیم .
چگونه کدهای نوشته شده را سریع اجرا کنم ؟ کلید میانبر ( HotKey ) اجرای کدها چیست ؟
پاسخ : فشردن کلید CTRL + Enter
امتحان کنید :
کد زیر را در بخش کدنویسی تایپ کنید و بوسیله کلید میانبر گفته شده ، آن را اجرا کنید .
تصویر ذیل نتیجه اجرای کدی هست که اجرا کردیم .
چند نکته :
دکمهها و حالتهای نمایش بخش کد نویسی
4 دکمه در قسمت کدنویسی وجود دارد :
بخش کد نویسی میتواند به 2 شکل نمایش داده شود :
9 دکمه هم در بالای بخش log وجود دارد ( به ترتیب از چپ به راست ) :
نمایش تعداد خطاهای اتفاق افتاده ، در نوار وضعیت ( Status Bar ) :
اگر در زمان فعال بودن فایرباگ ، در صفحه خطایی رخ دهد ، در نوار وضعیت عدد 1 را نمایش میدهد و به ازای هر خطای جدید ، یکی به تعداد خطاها اضافه میکند .
البته اگر از ورژنهای جدید فایرفاکس استفاده میکنید ، نوار وضعیت را نخواهید داشت و تعداد خطاها را در کنار آیکون فایرباگ خواهید داشت .
در کنار همه این امکانات ، فایرباگ یک مجموعه کامل از توابع کاربردی برای توسعه جاوا اسکریپت و خطایابی جاوا اسکریپت در اختیار ما میگذارد .
چند متد کمکی برای نوشتن Logهای مختلف در Console :
در قسمت بعدی توابع مربوط به توسعه جاوا اسکریپت ( Command Line API & Console API ) در فایرباگ را بررسی خواهیم کرد .
در این قسمت با تب Console آشنا خواهیم شد .
در قسمت قبل در مورد این تب گفتیم :
در این تب دو بخش وجود دارد :
در بخش Log هشدارها ، پیغامها ، درخواستهای XHR و ... نمایش داده میشوند .
بخش دیگر هم که در سمت راست قرار دارد ، مخصوص اجرای کدهای جاوا اسکریپت میباشد .
پس یک قسمت داریم برای نوشتن کدهای جاوا اسکریپت و یک قسمت هم برای مشاهدهی رویدادها .
اکنون 2 سوال مطرح میشود :
- برای اجرای یک کد در حالت معمول چگونه عمل میکنیم ؟
پاسخ : کدهای مورد نظر را بین تگ باز و بستهی script قرار میدهیم و صفحه مورد نظر را در مرورگر باز میکنیم و مرورگر کد را اجرا میکند . - در صورتی که کدهای ما خطا داشته باشند ، چگونه خطایابی میکنیم ؟
پاسخ : در بین کدهای نوشته شده چند alert قرار میدهیم و سعی میکنیم مشکل را پیدا کنیم .
همین 2 سوال اهمیت و قدرت فایرباگ و قسمت Console آن را برای ما آشکار میکند ، زیرا ما میتوانیم بدون Reload کردن صفحه ، کدهایمان را اجرا و نتیجه را مشاهده کنیم یا بوسیله توابع موجود خیلی ساده کدهایمان را خطایابی کنیم .
چگونه کدهای نوشته شده را سریع اجرا کنم ؟ کلید میانبر ( HotKey ) اجرای کدها چیست ؟
پاسخ : فشردن کلید CTRL + Enter
امتحان کنید :
کد زیر را در بخش کدنویسی تایپ کنید و بوسیله کلید میانبر گفته شده ، آن را اجرا کنید .
document.getElementsByTagName("div");
تصویر ذیل نتیجه اجرای کدی هست که اجرا کردیم .
چند نکته :
- قسمت هایی که با رنگ قرمز و یک دات ( . ) بعد از نام تگ قرار گرفته اند ، کلاسهای CSS ای هستند که المنت دارد .
- قسمت هایی که با رنگ آبی تیره و یک شارپ ( # ) بعد از نام تگ قرار گرفته اند ، ID تگها هستند .
- قسمت هایی که کمرنگ هستند ، المنت هایی هستند که در صفحه قابل نمایش نیستند .
- اگر یک تگ چند کلاس داشته باشد ، فقط اولین کلاس نمایش داده میشود .
دکمهها و حالتهای نمایش بخش کد نویسی
4 دکمه در قسمت کدنویسی وجود دارد :
- Run : اجرای کد
- Clear : خالی کردن بخش کد نویسی
- Copy : کپی کردن کد موجود در بخش کد نویسی در حافظه
- History : کدهای نوشته شده در نشست ( Session ) فعلی مرورگر
بخش کد نویسی میتواند به 2 شکل نمایش داده شود :
- بصورت جعبه چند خطی ( Command Editor )
- بصورت تک خطی ( Command Line )
9 دکمه هم در بالای بخش log وجود دارد ( به ترتیب از چپ به راست ) :
- دکمه ای با عنوان “Break On All Errors” . زمانی فعال شود ، در اولین اجرای یک کد از داخل صفحه ، به تب Script منتقل میشود و در خطی که کد در حال اجرا است توقف میکند .
- Clear : بخش log را خالی میکند .
- Persist : فعال بودن این دکمه باعث میشود که محتویات بخش Console در بارگزاری مجدد صفحه حفظ شود .
- Profile : بوسیله این گزینه میتوانید کدهای اجرایی خود در مدت زمان فعال بودن این دکمه ، تحت نظر بگیرید .
به این صورت که پس از غیر فعال کردن این دکمه ( کلیک مجدد بروی آن ) میتوانید تابعهای اجرا شده ، تعداد فراخوانی آنها ، مدت زمان اجرای هر یک ، میانگین زمان اجرای هر بار یک تابع و ... را مشاهده کنید . - 5 دکمهی بعدی هم برای فیلتر کردن Log هستند .
نمایش تعداد خطاهای اتفاق افتاده ، در نوار وضعیت ( Status Bar ) :
اگر در زمان فعال بودن فایرباگ ، در صفحه خطایی رخ دهد ، در نوار وضعیت عدد 1 را نمایش میدهد و به ازای هر خطای جدید ، یکی به تعداد خطاها اضافه میکند .
البته اگر از ورژنهای جدید فایرفاکس استفاده میکنید ، نوار وضعیت را نخواهید داشت و تعداد خطاها را در کنار آیکون فایرباگ خواهید داشت .
در کنار همه این امکانات ، فایرباگ یک مجموعه کامل از توابع کاربردی برای توسعه جاوا اسکریپت و خطایابی جاوا اسکریپت در اختیار ما میگذارد .
چند متد کمکی برای نوشتن Logهای مختلف در Console :
console.debug('This is a Debug message'); console.info('This is an Information'); console.warn('This is a Warning message'); console.error('This is an Error message');
در قسمت بعدی توابع مربوط به توسعه جاوا اسکریپت ( Command Line API & Console API ) در فایرباگ را بررسی خواهیم کرد .