كيفية دمج تطبيق iOS Flutter مع Firebase على نظام MacOS

Firebase عبارة عن نظام أساسي لتطوير تطبيقات الأجهزة المحمولة تم تطويره بواسطة شركة Firebase، Inc. في عام 2011 ، ثم حصلت عليها Google في عام 2014. وهي توفر ميزات متنوعة مثل التخزين السحابي والمصادقة ومجموعة ML ، والتي تعد ضرورية لتطوير تطبيقات الهاتف المحمول الحديثة.

بالإضافة إلى ذلك ، فإنه يوفر خدمات مثل مراقبة الأداء و Crashlytics و Google Analytics لمساعدتك على تحسين جودة تطبيقاتك.

في هذا البرنامج التعليمي ، سأوضح لك كيفية توصيل تطبيق Flutter iOS الخاص بك بمنصة Firebase على كمبيوتر Mac ، حتى تتمكن من الاستفادة من الخدمات القوية التي توفرها Firebase API في مساعيك المستقبلية ...

1. تجهيز حساب Gmail ومشروع Flutter

من أجل الاستفادة من الخدمات من Firebase و Google Cloud Platform ، ستحتاج إلى حساب Google. إذا لم يكن لديك واحد ، فما عليك سوى اتباع إرشادات الصفحة هنا للتسجيل للحصول على واحدة.

سيوضح لك هذا البرنامج التعليمي كيفية توصيل تطبيق Flutter الحالي بمنصة Firebase. إذا كنت مهتمًا بكيفية إنشاء تطبيق Flutter الأول ، فلدي برنامج تعليمي حول كيفية إنشاء أول تطبيق iOS Flutter على نظام MacOS . بنهاية هذا البرنامج التعليمي ، يجب أن يكون لديك تطبيق hello_world جاهز في المحاكي وأن تفهم كيفية تغيير التطبيق عن طريق تعديل ملف main.dart .

2. إنشاء مشروع Firebase

لدمج تطبيق Flutter مع Firebase Platform ، عليك أولاً إنشاء مشروع Firebase. وها هي الخطوات.

1. انتقل إلى Firebase Console .

2. انقر على زر " إضافة مشروع" الكبير .

3. أدخل اسم المشروع الخاص بك .

  • لقد استخدمت hello-world لهذا المثال. يقوم Firebase تلقائيًا بإلحاق معرف فريد باسم مشروعك - على سبيل المثال ، انتهى المشروع الذي أنشأته بالاسم hello-world-f2206 .

4. يمكنك اختيار موقع Cloud Firestore .

  • لقد تركتها كـ nam5 (us-central) لأنني أعيش في لوس أنجلوس ، لكن وظائف السحابة غير متوفرة على us-west2 ، وستؤدي حركة المرور بينهما إلى فرض رسوم إضافية. يمكنك العثور على المزيد حول توفر الخدمة ومواقع الخادم هنا .

5. قبول الشروط والأحكام .

5. بمجرد الانتهاء ، قم بالتمرير لأسفل وانقر فوق إنشاء مشروع .

  • راجع 3.1 التبديل إلى حساب المسؤول في الملحق في نهاية هذه المقالة إذا واجهت رسالة خطأ تطلب حساب مسؤول.

سيستغرق Firebase بعض الوقت لإعداد تطبيقك. بمجرد الانتهاء من ذلك ، انقر فوق الزر متابعة لفتح صفحة نظرة عامة على مشروع Firebase .

4. تكوين تطبيق iOS

1. في صفحة نظرة عامة على مشروع Firebase ، قم بتشغيل معالج الإعداد لنظام iOS .

2. داخل معالج الإعداد ، أدخل معرف حزمة iOS. في التطبيق سجل زر ثم ينبغي أن تضيء، اضغط عليها.

  • يمكن العثور على دليل حول كيفية العثور على معرف حزمة iOS أدناه في القسم 4.1 العثور على مجلد جذر مشروع iOS ومعرف حزمة الاكتساب للملحق.

3. قم بتنزيل ملف تكوين GoogleService-Info.plist وضعه في المجلد الجذر لمشروع iOS ، ثم انقر فوق " التالي" .

  • يمكن العثور على دليل حول كيفية العثور على معرّف حزمة iOS أدناه في القسم 4.1 العثور على مجلد جذر مشروع iOS واكتساب معرف حزمة الملحق.

4. اتبع التعليمات لإضافة Firebase SDK ، ثم انقر فوق " التالي" .

  • يمكن العثور على دليل مفصل حول كيفية تثبيت CocoaPods و Firebase SDK أدناه في القسم 4.2 تثبيت CocoaPods و Firebase SDK .

5. قم بتعديل الكود الموجود داخل AppDelegate الرئيسي وفقًا لتعليمات معالج الإعداد ثم انقر فوق التالي . في هذا المثال ، استخدمت Objective-C ، وبالتالي استبدلت المحتويات داخل AppDelegate.m بالكود التالي.

#include "AppDelegate.h" #include "GeneratedPluginRegistrant.h" @import UIKit; @import Firebase; @implementation AppDelegate - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [FIRApp configure]; return YES; } @end

6. ارجع إلى المجلد الجذر وشغّل تطبيقك ، بعد فترة من المفترض أن ترى معالج الإعداد يُظهر إضافة تطبيقك إلى Firebase. انقر فوق " متابعة إلى وحدة التحكم" لإنهاء الإعداد.

تهانينا! لقد نجحت في إضافة Firebase إلى تطبيق Flutter. على الرغم من حقيقة أن امتلاك Firebase و Flutter من Google أمر رائع ، إلا أنه من الممارسات الجيدة في هندسة البرمجيات أن يكون لديك دائمًا خطة B ، بالإضافة إلى الخطة C و D و E و F و G. في المستقبل سأفعل اكتب دليلاً آخر حول تطبيق نموذجي يستخدم Firebase ، والمزيد على Flutter.

استمتع بالشفرة !!!

الملحقات:

3.1 التبديل إلى حساب المسؤول

إذا واجهت الرسالة التالية ، فهذا يعني أنك بحاجة إلى الاتصال بمؤسسة حساب Gmail الخاص بك لمنحك حق الوصول إلى Google Developers Console .

4.1 البحث عن المجلد الجذر لمشروع iOS والحصول على معرف الحزمة

1. قم بتشغيل Xcode من Launchpad .

2. Select “Open another project…” at the bottom of the prompt screen.

3. Navigate to your Flutter project folder, open the “ios” folder and select “Runner.xcodeproj”. This should automatically open up the project in Xcode.

4. Select the Runner project on the left, you should now see the Bundle Identifier under Identity.

4.2 Installing CocoaPods and Firebase SDK

In case the instructions inside the setup wizard did not work out, you will have to remove the existing Podfile in order to reinstall them correctly.

1. CocoaPods is built with Ruby and is installable with the default Ruby available on MacOS. Use the following commands to install it.

sudo gem install cocoapods

2. Initialize the Podfile with the following command.

pod init

3. Then, add the following code to the initialized Podfile.

pod 'Firebase/Core'

4. Once done, save the changes made to the Podfile, and install the Firebase SDK with the following command.

pod install

5. After the installation, you will likely have to configure the .xcconfig files. First you will have to copy the files from the Pods/Target Support Files/Pods-Runner folder to Flutter folder.

6. ثم سيكون لديك لتضمينها في Debug.xcconfig و Release.xcconfig الملفات داخل الرفرفة المجلد.

في Debug.xcconfig :

#include "Pods-Runner.debug.xcconfig"

في Release.xcconfig :

#include "Pods-Runner.profile.xcconfig" #include "Pods-Runner.release.xcconfig"