GraphQL API مع Swift: دليل تعليمي عملي خطوة بخطوة

مقدمة إلى GraphQL وSwift

GraphQL هي لغة استعلام لواجهات API تتيح للعملاء الحصول على البيانات التي يحتاجونها بالضبط دون أي زيادة. لمطوري iOS وmacOS، يفتح دمج GraphQL إمكانيات جديدة لإنشاء تطبيقات جوال فعالة ومرنة. في هذا الدليل التعليمي، سنشرح عمليًا كيفية ربط GraphQL API بمشروع Swift، وتنفيذ الاستعلامات والطفرات الأساسية، بالإضافة إلى معالجة الأخطاء المحتملة.

على عكس REST التقليدي، يتيح GraphQL طلب موارد متعددة في استعلام واحد، وهو أمر مهم بشكل خاص للأجهزة المحمولة ذات حركة المرور المحدودة. سنستخدم المكتبة الشهيرة Apollo iOS - الحل الأكثر استقرارًا وتوثيقًا للعمل مع GraphQL على Swift.

تحضير المشروع وتثبيت Apollo iOS

الخطوة 1: إنشاء المشروع وتثبيت التبعيات

افتح Xcode وأنشئ مشروع iOS جديد (أو macOS). للعمل مع GraphQL، سنقوم بتثبيت Apollo iOS عبر Swift Package Manager (SPM).

\n
1. في Xcode، اختر File → Add Packages
\n
2. أدخل رابط المستودع: https://github.com/apollographql/apollo-ios.git
\n
3. اختر أحدث إصدار مستقر (في وقت الكتابة - 1.15+)
\n
4. أضف الحزمة إلى هدفك
\n

الخطوة 2: توليد الكود بناءً على مخطط GraphQL

يستخدم Apollo iOS توليد الكود: تصف الاستعلامات في ملفات .graphql، وتقوم الأداة بإنشاء كود Swift بنماذج بيانات محددة. للقيام بذلك، يجب:

\n
1. إنشاء مجلد GraphQL في المشروع
\n
2. وضع ملف schema.graphqls (مخطط API الخاص بك) فيه - يمكن الحصول عليه عادةً عبر introspection
\n
3. إنشاء ملف استعلام، مثل GetUser.graphql:
\n

query GetUser($id: ID!) {\n  user(id: $id) {\n    id\n    name\n    email\n    posts {\n      title\n    }\n  }\n}

ثم أضف Build Phase لتشغيل مولد الكود. أسهل طريقة هي تثبيت Apollo CLI عبر Homebrew:

brew install apollo-ios-cli

ونفذ الأمر في جذر المشروع:

./apollo-ios-cli generate

بعد ذلك، ستظهر ملفات Swift المُنشأة مع نماذج البيانات في مجلد Sources/API.

تنفيذ استعلامات GraphQL الأساسية

إعداد عميل Apollo

أنشئ مثيلاً لعميل Apollo مع تحديد رابط نقطة نهاية GraphQL الخاصة بك. يتم ذلك عادةً في AppDelegate أو في فئة خدمة منفصلة:

import Apollo\n\nclass NetworkService {\n    static let shared = NetworkService()\n    private(set) lazy var apollo: ApolloClient = {\n        let url = URL(string: "https://your-api.com/graphql")!\n        return ApolloClient(url: url)\n    }()\n}

استعلام البيانات (Query)

الآن سنقوم بتنفيذ استعلام لجلب مستخدم. سينشئ الكود المُنشأ هيكل GetUserQuery:

import Foundation\n\nclass UserViewModel: ObservableObject {\n    @Published var user: User?\n    @Published var errorMessage: String?\n    \n    func fetchUser(id: String) {\n        NetworkService.shared.apollo.fetch(query: GetUserQuery(id: id)) { [weak self] result in\n            DispatchQueue.main.async {\n                switch result {\n                case .success(let graphQLResult):\n                    if let userData = graphQLResult.data?.user {\n                        self?.user = User(\n                            id: userData.id,\n                            name: userData.name,\n                            email: userData.email\n                        )\n                    }\n                case .failure(let error):\n                    self?.errorMessage = "خطأ: \\(error.localizedDescription)"\n                }\n            }\n        }\n    }\n}

لاحظ: نستخدم @Published لتحديث واجهة المستخدم بشكل تفاعلي في