تسجيل الدخول بـ Google (المتابعة باستخدام Google)

1ما الذي يمنحه هذا لتطبيقك#

يضيف زر 'Continue with Google' إلى التطبيقات التي تنشئها في AI Studio، ليسجّل مستخدموك الدخول بحساب Google بدلًا من كتابة بريد وكلمة مرور جديدين.

إنه BRING-YOUR-OWN: يستخدم الزر تسجيل Google الخاص بك، على شاشة الموافقة الخاصة بك، لمستخدميك. لا يستضيف AppMint أي تسجيل دخول ولا يخزّن شيئًا - تلصق بيانات اعتماد Google مرة واحدة ويمكن لكل تطبيق تنشئه إعادة استخدامها.

لا تكتب أي كود. يضيف الذكاء الاصطناعي الزر ومنطق تسجيل الدخول عندما تطلبه؛ ولا يُشحن السر داخل التطبيق أبدًا.

2اربط Supabase أولًا (مطلوب)#

يعتمد تسجيل الدخول بـ Google في التطبيقات المُنشأة على Supabase Auth، لذا يجب أن يكون Supabase متصلًا ومفعّلًا أولًا (Settings ← BACKEND - SUPABASE). إذا لم يكن Supabase نشطًا، فلن يظهر زر Google. يشرح الفصل '🗄️ Supabase Backend (Connect It Once)' في أعلى هذا الدليل كيفية ربطه.

السبب: حسابات مستخدميك تعيش في مشروع Supabase الخاص بك. يدفع AppMint بيانات اعتماد Google الخاصة بك إلى ذلك المشروع تلقائيًا عند النشر - فلا تضطر إلى تفعيل مفتاح Google بنفسك داخل لوحة Supabase.

3أنشئ عميل Google OAuth (5 دقائق، مجاني)#

على حاسوب، في وحدة تحكم Google Auth Platform (نقلت Google إعداد OAuth إليها مؤخرًا من 'APIs & Services'):

1. افتح console.cloud.google.com/auth واختر (أو أنشئ) أي مشروع.
2. لأول مرة فقط - اضبط شاشة الموافقة: تحت 'Branding' أضف اسم تطبيق وبريد الدعم، وتحت 'Audience' اختر 'External' وانشر التطبيق أو أضف نفسك كمستخدم اختبار.
3. افتح 'Clients' ← اضغط 'Create client'.
4. Application type: اختر 'Web application' (وليس Android - فتسجيل الدخول يتم عبر Supabase على الويب).
5. سمّه واضغط 'Create'. ستحصل على Client ID (ينتهي بـ .apps.googleusercontent.com) وClient secret. أبقِ هذا التبويب مفتوحًا للخطوة التالية.

افتح Google Auth Platform ← Clients ←

4أضف رابط callback الخاص بـ Supabase كـ redirect URI#

هذه هي الخطوة التي ينساها الجميع - بدونها يعرض Google خطأ 'redirect_uri_mismatch'.

1. اعثر على مرجع مشروع Supabase: هو الجزء '<ref>' من رابط مشروعك https://<ref>.supabase.co (لوحة Supabase ← Project Settings ← API).
2. ارجع إلى عميل Google OAuth الذي أنشأته للتو، وتحت 'Authorized redirect URIs' اضغط 'Add URI' والصق بالضبط:

 https://<ref>.supabase.co/auth/v1/callback

1. استبدل <ref> بمرجع مشروعك الحقيقي ثم Save.

https://<ref>.supabase.co/auth/v1/callback

5الصق بيانات اعتمادك في AppMint#

في AI Studio، صِف ببساطة تطبيقًا يحتاج إلى حسابات واطلب تسجيل الدخول بـ Google - مثل 'let users sign in with Google'. في المرة الأولى، يعرض AppMint نافذة 'Connect Google sign-in':

1. الصق Google OAuth Client ID الخاص بك (…apps.googleusercontent.com).
2. الصق Google OAuth Client Secret الخاص بك.
3. اضغط 'Save & continue'.

تُخزَّن مشفّرة على جهازك وتُعاد استخدامها لكل تطبيق مستقبلي - تلصقها مرة واحدة فقط. (اضغط 'Skip Google' إذا غيّرت رأيك؛ سيُبنى التطبيق رغم ذلك، لكن دون الزر.)

6كيف يعمل على هاتف حقيقي#

يحظر Google شاشة تسجيل الدخول الخاصة به داخل WebView المضمّن في التطبيق، لذا يتعامل AppMint مع ذلك بالطريقة الآمنة تلقائيًا - ولا شيء عليك ضبطه:

• الضغط على 'Continue with Google' يفتح المتصفح الحقيقي لشاشة الموافقة.
• بعد موافقة المستخدم، يعود إلى تطبيقك عبر رابط عميق آمن ويكمل تسجيل الدخول.

يعمل هذا في المعاينة المباشرة وفي APK المثبَّت على حد سواء. يستخدم كل تطبيق مُنشأ رابط عودة خاصًا به، فلا تتعارض تطبيقات AppMint المتعددة أبدًا.

7تحقق من أنه يعمل#

1. افتح تطبيقك (المعاينة أو APK المثبَّت) واضغط 'Continue with Google'.
2. يفتح المتصفح، وتختار حساب Google الخاص بك، ثم تعود إلى التطبيق وقد سجّلت الدخول.
3. في لوحة Supabase ← Authentication ← Users، يظهر حساب Google الخاص بك الآن.

إذا عمل في المعاينة فسيعمل في APK المبني - فالمسار متطابق.

8إذا لم يعمل شيء#

• 'redirect_uri_mismatch' ← لا يطابق redirect URI في الخطوة 4 تمامًا. يجب أن يكون https://<ref>.supabase.co/auth/v1/callback بمرجعك أنت، دون شرطة مائلة في النهاية ودون أخطاء إملائية.

• لا يظهر الزر ← Supabase غير نشط (الخطوة 2)، أو ضغطت 'Skip Google'. أعد فتح وصف التطبيق مع طلب تسجيل الدخول بـ Google.

• 'Access blocked: app not verified' ← ما زالت شاشة موافقة OAuth في وضع Testing. أضف حساب Google الخاص بك كمستخدم اختبار، أو انشر شاشة الموافقة.

• يُعرض Google فقط - تسجيل الدخول بـ Apple / X (Twitter) غير مدعوم عبر Supabase (نوافذ OAuth المنبثقة التي يحظرها Android WebView)؛ ويعمل Facebook عبر تسجيل الدخول الخاص بالتطبيق (المعالج، خطوة Integrate). ويستمر البريد/كلمة المرور بالعمل إلى جانب Google.

• التطبيقات دون اتصال (بلا خلفية) لا تحصل على أي تسجيل دخول اجتماعي - إذ لا يوجد Supabase للمصادقة معه.