Alamofire در Swift

Alamofire

Alamofire در Swift کتابخانه‌ای‌ست برای مدیریت ارتباطات اینترنتی اپلیکیشن.

Alamofire

Alamofire

نصب Alamofire

برای استفاده از Alamofire در Swift، ابتدا CocoaPods رانصب کنید. پس از نصب CocoaPods، با اپ Terminal، به مسیر پروژه رفته و عبارت زیر را تایپ کنید:

با اجرای دستور بالا، در فولدر پروژه دو فایل به نام‌های Podfile و Podfile.lock ایجاد شده است. فایل Podfile رو با استفاده از یک TextEditor باز کنید و مانند زیر آن را تغییر دهید:

دقت کنید که هنگام نگارش این نوشته، آخرین نسخه از Alamofire، شماره ۴.۷ می‌باشد. برای نصب به صفحه گیت‌هاب Alamofire مراجعه کنید (+).
پس از انجام تغییرات بالا، در ترمینال، دستور pod install را وارد کنید تا podهای مورد نظر نصب شوند. پس از نصب، در فولدر پروژه یک فایل با پسوند .xcworkspace ایجاد شده است. از این به بعد برای باز کردن پروژه از این فایل استفاده کنید.
هنگام باز کردن پروژه، کمی صبر کنید تا پروژه فایل‌های جدید را ایندکس کند. بهتر است یک بار پروژه را Clean و سپس Rebuild کنید.
در ابتدای فایل ViewControlیی که می خواهید از Alamofire استفاده کنید، import Alamofire را وارد کنید تا بتوانید از Alamofire استفاده کنید.
همانند کد زیر می‌توانید به سرویس خود متصل شوید:

در کد بالا ابتدا پارامترهای ارسالی در یک آرایه قرار گرفته‌اند. با استفاده از request یک درخواست ایجاد می‌شود. این درخواست حاوی آدرس Api، متد ارسالی، و همچنین پارامترهای ارسالی به Api می‌باشد. responseString تعیین می‌کند که جواب بازگشتی به صورت یک رشته باشد و در response قرار گیرد. همچنین response چاپ می‌گردد.
اگر رشته بازگشتی شما به صورت json باشد، می‌توان با استفاده از پاد JASON رشته را به صورت یک شیئ json تبدیل کرد و از آن استفاده کرد. برای نصب JASON در Podfile خط زیر را اضافه کنید:

پس از اجرای دوباره دستور pod install در ترمینال و نصب pod مورد نظر، کدهای بالا رو به صورت زیر تغییر دهید‌:

با JSON پاسخ برگشتی از Api تبدیل به یک شیئ json می‌شود و می توان به روش‌های گوناگون از آن استفاده کرد.

تست کدها با Slim FrameWork

برای تست کد‌های بالا، پس از نصب Slim FrameWork در سرور، تابع زیر را در فایل routes.php وارد کنید:

JASON

JASON

SlimFramework

SlimFramework

Alamofire

Alamofire

نصب CocoaPods

CocoaPods چیست؟
CocoaPods همانند HomeBrew یک سیستم مدیریت پکیج، شامل بیش از ۱۸۰۰ کتابخانه و کنترل است. با نصب CocoaPods می توان این پکیج ها را به پروژه های iOS اضافه کرد و از آن ها استفاده کرد. از جمله پکیج های معروف می توان به Alamofire و SQLite.swift اشاره کرد.

نصب CocoaPods
برای نصب و همچنین آپدیت CocoaPods در اپ Terminal کد زیر را وارد کنید.

پس از وارد کردن دستور بالا، باید رمز عبور دستگاه خود را وارد کنید و منتظر تکمیل نصب باشید.

اضافه کردن Pods به پروژه
به هر پکیج موجود در CocoaPods یک Pod گفته می شود. برای اضافه کردن Pod به پروژه خود، در اپ Terminal با استفاده از دستور cd به پوشه پروژه خود وارد شوید. دستور pod init را اجرا کنید. در پوشه پروژه یک فایل به نام Podfile ایجاد شده است. فایل را TextEditor باز کرده و نام و نسخه پکیج مورد نظر را وارد کنید. به عنوان مثال برای پکیج Alamofire باید فایل خود را مطابق زیر ویرایش کنید:

پس از ذخیره فایل، در Terminal دستور pod install را اجرا کنید. خروجی ترمینال به صورت زیر است:

کتابخانه مورد نظر نصب شد. : )
در پوشه پروژه یک فایل با پسوند xcworkspace ایجاد شده است که از این به بعد برای باز کردن پروژه، این فایل را باز کنید.
در وارد کردن Podها دو نکته قابل توجه است:

  • نسخه iOS
  • کامنت بودن یا نبودن use_frameworks!
  • دو مورد بالا در راهنمای نصب Podهای مورد نظر نوشته شده است.
    در آخر حتما سری به سایت CocoaControls سر بزنید. این سایت شامل کنترل های فراوانی است که از طریق CocoaPods می توانید به پروژه خود اضافه کنید.

    نصب HomeBrew

    HomeBrew چیست؟
    HomeBrew یک سیستم نرم افزاری مدیریت پکیج است که توسط Max Howell در سال ۲۰۰۹ برای سیستم OSX اپل و با استفاده از زبان Ruby ایجاد شد. با استفاده از HomeBrew می توان پکیج های مورد نظر را توسط ترمینال به سیستم عامل یا پروژه های iOS اضافه یا نصب فونت را انجام داد.

    نصب HomeBrew
    در Spotlight کلمه Terminal را جستجو و اپ مربوطه را اجرا کنید. در خط فرمان دستور زیر را وارد کنید:

    HomeBrew نصب شد. : )
    با دستور brew می توان از HomeBrew استفاده کرد. برای مثال دستور brew update را اجرا کنید. این دستور پکیج cask را نصب و HomeBrew را آپدیت می کند (در آینده از پکیج cask استفاده می کنیم).
    برای اطلاعات بیشتر از این سیستم نرم افزاری به سایت خود HomeBrew به brew.sh مراجعه کنید.

    برای تمرین می توانید فونت FiraCode با استفاده از brew بر روی سیستم خود نصب کنید.
    پ.ن : این پست، شروعی برای آموزش برنامه نویسی iOS با استفاده از زبان Swift است.

    Reformat کد در XCode

    Reformat کد در XCode یکی از مشکلاتی بود که من با XCode داشتم. به دلیل اینکه من در مک از Shortkey های مختلفی استفاده می کنم که با Shortkey های XCode یکی هستند، به راحتی نمی توانستم از Reformat کدها استفاده کنم. به همین دلیل دنبال راهی برای رفع این مشکل گشتم. یکی از افزونه هایی که پیدا کردم، Swimat بود.
    برای نصب Swimat دو روش وجود دارد. با استفاده از ترمینال و clone کردن سورس گیت هاب آن، و دیگری دانلود فایل نصب افزونه از اینجا (توصیه می شود برای دانلود حتما به خود صفحه مراجعه کنید.)
    پس از نصب افزونه، حتما به [System Preferences] -> [Extensions] -> [Xcode Source Editor] بروید و مطمئن شوید که Swimat انتخاب شده است. یک بار XCode را ریستارت کنید. وقتی در صفحه ادیتور کد هستید از [Edit] -> [Swimat] -> [Format] کد را فرمت کنید.
    همچنین با مراجعه به Key Binding می توانید Shortkey مورد نظر خود را انتخاب کنید.

    Reformat کد در XCode

    select shortkey for Swimat in xcode

    اتصال به پرینتر Share شده ویندوز در macOS

    یکی از مشکلات من در شرکت، اتصال به پرینتر Share شده ویندوز در macOS بود. اتصال به همچین پرینتری در ویندوز راحت هست اما در macOS کمی پیچیدگی دارد.
    برای اتصال به پرینتر Share شده ویندوز در macOS به بخش Printers & Scanners در System Preferences وارد شوید. دکمه + را برای اضافه کردن پرینتر فشار دهید. در صفحه Add برروی فضای بالای صفحه، مانند تصاویر زیر، منو را باز کنید و گزینه Customize Toolbar را انتخاب و دکمه Advanced را به Toolbar اضافه کنید.

    اتصال به پرینتر Share شده ویندوز در macOS

    Show customize toolbar menu in add printer in macos

    اتصال به پرینتر Share شده ویندوز در macOS

    Add advanced to add printer toolbar in macos

    در قسمت Advanced، گزینه Type را بر روی Windows printer via spoolss تنظیم کنید. بخش URL را به صورت زیر پر کنید:

    دقت کنید که اگر در اسم پرینتر شما فاصله وجود دارد به جای فاصله از ۲۰% استفاده کنید و حتما در نوشتن نام پرینتر حروف بزرگ و کوچک را رعایت کنید چون در صورت رعایت نکردن پرینتر به درستی نصب نمی شود. پیشنهاد من این است که نام پرینتر را از ویندوز کپی و در مک از آن استفاده کنید.
    بخش Name و Location را پر کنید. در قسمت User گزینه Select software را انتخاب و درایور پرینتر را انتخاب کنید. توجه کنید اگر درایور پرینتر را پیدا نکردید، یک بار پرینتر را با استفاده از USB به لپ تاپ خود وصل کنید تا درایور نصب شود و دوباره مراحل بالا را تحت شبکه انجام دهید.
    پس از اتمام کار دکمه Add را زده و نام پرینتر را در لیست پرینترهای خود مشاهده می کنید. یک داکیومنت و یا PDF را باز کنید و با زدن دکمه های command+P استفاده از پرینتر خود را تست کنید.
    توصبه می شود پس از نصب پرینتر به App Store بروید و اگر برای درایور پرینتر آپدیتی بود حتما آپدیت کنید.