ورود با Google (ادامه با Google)

1این قابلیت به اپلیکیشن شما چه می‌دهد#

یک دکمه «Continue with Google» به اپلیکیشن‌هایی که در AI Studio می‌سازید اضافه می‌کند، تا کاربران به‌جای تایپ ایمیل و رمز عبور جدید، با حساب Google خود وارد شوند.

این مدل «خودتان بیاورید» است: دکمه از ورود Google خودتان، روی صفحه رضایت خودتان، برای کاربران خودتان استفاده می‌کند. AppMint هیچ ورودی را میزبانی نمی‌کند و چیزی ذخیره نمی‌کند - اطلاعات Google خود را یک بار جای‌گذاری می‌کنید و هر اپلیکیشنی که می‌سازید می‌تواند از آن‌ها دوباره استفاده کند.

هیچ کدی نمی‌نویسید. وقتی درخواست می‌کنید، هوش مصنوعی دکمه و منطق ورود را اضافه می‌کند؛ راز هرگز داخل اپلیکیشن ارسال نمی‌شود.

2اول Supabase را متصل کنید (الزامی)#

ورود با Google برای اپلیکیشن‌های ساخته‌شده روی Supabase Auth سوار است، پس باید اول Supabase را متصل و فعال کرده باشید (Settings ← BACKEND - SUPABASE). اگر Supabase فعال نباشد، دکمه Google ظاهر نمی‌شود. فصل «🗄️ بک‌اند Supabase (یک بار متصل کنید)» در بالای این راهنما اتصال آن را مرحله‌به‌مرحله توضیح می‌دهد.

دلیل: حساب‌های کاربران شما در پروژه Supabase خودتان هستند. AppMint هنگام استقرار، اطلاعات Google شما را خودکار به آن پروژه می‌فرستد - لازم نیست خودتان کلید Google را داخل داشبورد Supabase روشن کنید.

3یک کلاینت Google OAuth بسازید (۵ دقیقه، رایگان)#

روی رایانه، در کنسول Google Auth Platform (Google به‌تازگی راه‌اندازی OAuth را از «APIs & Services» به اینجا منتقل کرده):

1. console.cloud.google.com/auth را باز کنید و یک پروژه را انتخاب (یا بسازید).
2. فقط بار اول - صفحه رضایت را پیکربندی کنید: زیر «Branding» نام اپلیکیشن و ایمیل پشتیبانی را اضافه کنید و زیر «Audience» گزینه «External» را انتخاب کنید و یا اپلیکیشن را منتشر کنید یا خودتان را به‌عنوان کاربر آزمایشی اضافه کنید.
3. «Clients» را باز کنید ← روی «Create client» کلیک کنید.
4. نوع اپلیکیشن: «Web application» را انتخاب کنید (نه Android - ورود از طریق Supabase روی وب انجام می‌شود).
5. نامی بدهید و روی «Create» کلیک کنید. یک Client ID (با .apps.googleusercontent.com تمام می‌شود) و یک Client secret می‌گیرید. این تب را برای مرحله بعد باز نگه دارید.

Google Auth Platform ← Clients را باز کنید ←

4callback مربوط به 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> را با شناسه مرجع واقعی پروژه خود جایگزین کنید و ذخیره کنید.

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 خود را جای‌گذاری کنید (…apps.googleusercontent.com).
2. Client Secret مربوط به Google OAuth خود را جای‌گذاری کنید.
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 در مرحله ۴ دقیقاً مطابقت ندارد. باید https://<ref>.supabase.co/auth/v1/callback با شناسه مرجع خودتان باشد، بدون اسلش انتهایی و بدون غلط تایپی.

• دکمه ظاهر نمی‌شود ← Supabase فعال نیست (مرحله ۲)، یا روی «Skip Google» زده‌اید. توضیح اپلیکیشن را دوباره با درخواست ورود با Google باز کنید.

• «Access blocked: app not verified» ← صفحه رضایت OAuth شما هنوز در حالت Testing است. حساب Google خود را به‌عنوان کاربر آزمایشی اضافه کنید، یا صفحه رضایت را منتشر کنید.

• فقط Google ارائه می‌شود - ورود با Apple / X (Twitter) از طریق Supabase پشتیبانی نمی‌شود (پنجره‌های OAuth که Android WebView مسدود می‌کند)؛ Facebook از طریق ورود Facebook خود اپلیکیشن کار می‌کند (جادوگر، مرحله Integrate). ایمیل/رمز عبور هم کنار Google کار می‌کند.

• اپلیکیشن‌های آفلاین (بدون بک‌اند) اصلاً ورود اجتماعی ندارند - Supabase‌ای برای احرازهویت وجود ندارد.