با ادغام «ورود به سیستم با Google» در برنامهتان، میتوانید به کاربرانتان اجازه دهید بااستفاده از «حساب Google» خودشان در Firebase اصالتسنجی کنند.
پیامواره هوش مصنوعی برای کمک هوش مصنوعی
برای کمک هوش مصنوعی، پیامواره زیر را در عامل کدنویسی هوش مصنوعی خود (مانند Antigravity، Claude Code، Codex، و Cursor) کپی کنید. میتوانید پیامواره را سفارشیسازی کنید و با عاملتان تکرار کنید. برای اطلاعات دقیق نصب، به مهارتهای عامل Firebase مراجعه کنید.
Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up and use Firebase Authentication with Google Sign-In in my app.
قبل از شروع
از Swift Package Manager برای نصب و مدیریت وابستگیهای Firebase استفاده کنید.
- در Xcode، درحالیکه پروژه برنامهتان باز است، به File (فایل) > Add Packages (افزودن بستهها) بروید.
- وقتی خواسته شد، مخزن کیت توسعه نرمافزار Firebase Apple platforms را اضافه کنید:
- کتابخانه Firebase Authentication را انتخاب کنید.
- پرچم
-ObjCرا به بخش Other Linker Flags (سایر پرچمهای پیونددهنده) در تنظیمات ساخت هدف اضافه کنید. - وقتی تمام شد، Xcode بهطور خودکار شروع به حل و بارگیری وابستگیهای شما در پسزمینه میکند.
https://github.com/firebase/firebase-ios-sdk.git
افزودن کیت توسعه نرمافزار «ورود به سیستم با Google» به پروژه
در Xcode، درحالیکه پروژه برنامهتان باز است، به File (فایل) > Add Packages (افزودن بستهها) بروید.
وقتی درخواست شد، مخزن Google Sign-In SDK را اضافه کنید:
https://github.com/google/GoogleSignIn-iOSوقتی تمام شد، Xcode بهطور خودکار شروع به حل و بارگیری وابستگیهای شما در پسزمینه میکند.
فعال کردن «ورود به سیستم با Google» برای پروژه Firebase
برای اینکه کاربران بتوانند بااستفاده از «ورود به سیستم با Google» به سیستم وارد شوند، ابتدا باید ارائهدهنده «ورود به سیستم با Google» را برای پروژه Firebase خود فعال کنید:
در کنسول Firebase، به امنیت > اصالتسنجی بروید.
در برگه روش ورود به سیستم، ارائهدهنده Google را فعال کنید.
روی ذخیره کردن کلیک کنید.
نسخه جدیدی از فایل
GoogleService-Info.plistپروژهتان را بارگیری کنید و آن را در پروژه Xcode خود کپی کنید. نسخه جدید را روی نسخههای موجود رونویسی کنید. (به افزودن Firebase به پروژه iOS مراجعه کنید.)
وارد کردن فایلهای سرایند موردنیاز
ابتدا باید فایلهای سرایند «کیت توسعه نرمافزار Firebase» و «کیت توسعه نرمافزار ورود به سیستم با Google» را به برنامهتان وارد کنید.
Swift
import FirebaseAuth import GoogleSignIn
Objective-C
@import FirebaseCore; @import GoogleSignIn;
پیادهسازی «ورود به سیستم با Google»
با دنبال کردن این مراحل، «ورود به سیستم با Google» را پیادهسازی کنید. برای جزئیات مربوط به استفاده از «ورود به سیستم با Google» در iOS، به مستندات توسعهدهنده «ورود به سیستم با Google» مراجعه کنید.
- طرحوارههای نشانی وب سفارشی را به پروژه Xcode خود اضافه کنید:
- پیکربندی پروژه را باز کنید: روی نام پروژه در نمای درختی سمت راست کلیک کنید. برنامهتان را از بخش TARGETS انتخاب کنید، سپس برگه Info را انتخاب کنید و بخش URL Types را ازهم باز کنید.
- روی دکمه + کلیک کنید و طرحواره نشانی وب را برای شناسه کارخواه معکوسشدهتان اضافه کنید. برای پیدا کردن این مقدار، فایل پیکربندی
را باز کنید و بهدنبال کلیدGoogleService-Info.plist REVERSED_CLIENT_IDبگردید. مقدار آن کلید را کپی کنید، و آن را در چارگوش طرحوارههای نشانی وب در صفحه پیکربندی جایگذاری کنید. بقیه فیلدها را بدون تغییر باقی بگذارید.پساز تکمیل، پیکربندی شما باید چیزی شبیه به موارد زیر باشد (اما با مقادیر مختص برنامهتان):
- در روش
application:didFinishLaunchingWithOptions:نماینده برنامهتان، شیءFirebaseAppرا پیکربندی کنید.Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- روش
application:openURL:options:را در نماینده برنامهتان پیادهسازی کنید. این روش باید روشhandleURLاز نمونهGIDSignInرا فراخوانی کند، که بهدرستی نشانی وبی را که برنامه شما در پایان فرایند اصالتسنجی دریافت میکند مدیریت خواهد کرد.Swift
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) { // ... } return GIDSignIn.sharedInstance.handle(url) }
Objective-C
- (BOOL)application:(nonnull UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<NSString *, id> *)options { return [[GIDSignIn sharedInstance] handleURL:url]; }
- کنترلکننده نمای ارائهدهنده و شناسه مشتری را برای برنامهتان به روش
signInارائهدهنده «ورود به سیستم با Google» ارسال کنید و از شناسه اصالتسنجی Google حاصل، اعتبارنامه «اصالتسنجی Firebase» ایجاد کنید:Swift
guard let clientID = FirebaseApp.app()?.options.clientID else { return } // Create Google Sign In configuration object. let config = GIDConfiguration(clientID: clientID) GIDSignIn.sharedInstance.configuration = config // Start the sign in flow! GIDSignIn.sharedInstance.signIn(withPresenting: viewController) { result, error in guard error == nil else { // ... return } guard let user = result?.user, let idToken = user.idToken?.tokenString else { // ... return } let credential = GoogleAuthProvider.credential(withIDToken: idToken, accessToken: user.accessToken.tokenString) self.signIn(with: credential) }
Objective-C
GIDConfiguration *config = [[GIDConfiguration alloc] initWithClientID:[FIRApp defaultApp].options.clientID]; [GIDSignIn.sharedInstance setConfiguration:config]; __weak __auto_type weakSelf = self; [GIDSignIn.sharedInstance signInWithPresentingViewController:self completion:^(GIDSignInResult * _Nullable result, NSError * _Nullable error) { __auto_type strongSelf = weakSelf; if (strongSelf == nil) { return; } if (error == nil) { FIRAuthCredential *credential = [FIRGoogleAuthProvider credentialWithIDToken:result.user.idToken.tokenString accessToken:result.user.accessToken.tokenString]; // ... } else { // ... } }];
GIDSignInButtonرا به فیلمنامه مصور، فایل XIB، یا نمونهسازی برنامهای آن اضافه کنید. برای افزودن دکمه به استوریبرد یا فایل XIB، یک View اضافه کنید و کلاس سفارشی آن را رویGIDSignInButtonتنظیم کنید.- اختیاری: اگر میخواهید دکمه را سفارشیسازی کنید، کارهای زیر را انجام دهید:
Swift
- در کنترلکننده نمای خود، دکمه ورود به سیستم را بهعنوان یک ویژگی اعلام کنید.
@IBOutlet weak var signInButton: GIDSignInButton!
- دکمه را به دارایی
signInButtonکه بهتازگی اعلام کردید متصل کنید. - دکمه را با تنظیم کردن ویژگیهای شیء GIDSignInButton سفارشیسازی کنید.
Objective-C
- در فایل سرایند کنترلکننده نمای خود، دکمه ورود به سیستم را بهعنوان یک
ویژگی اعلام کنید.
@property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
- دکمه را به دارایی
signInButtonکه بهتازگی اعلام کردید متصل کنید. - دکمه را با تنظیم کردن ویژگیهای شیء GIDSignInButton سفارشیسازی کنید.
- در کنترلکننده نمای خود، دکمه ورود به سیستم را بهعنوان یک ویژگی اعلام کنید.
اصالتسنجی با Firebase
درنهایت، فرایند ورود به سیستم Firebase را با اطلاعات اعتباری اصالتسنجی ایجادشده در مرحله قبل تکمیل کنید.
Swift
Auth.auth().signIn(with: credential) { result, error in guard error == nil else { // ... return } // At this point, our user is signed in }
Objective-C
[[FIRAuth auth] signInWithCredential:credential completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (isMFAEnabled && error && error.code == FIRAuthErrorCodeSecondFactorRequired) { FIRMultiFactorResolver *resolver = error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey]; NSMutableString *displayNameString = [NSMutableString string]; for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) { [displayNameString appendString:tmpFactorInfo.displayName]; [displayNameString appendString:@" "]; } [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Select factor to sign in\n%@", displayNameString] completionBlock:^(BOOL userPressedOK, NSString *_Nullable displayName) { FIRPhoneMultiFactorInfo* selectedHint; for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) { if ([displayName isEqualToString:tmpFactorInfo.displayName]) { selectedHint = (FIRPhoneMultiFactorInfo *)tmpFactorInfo; } } [FIRPhoneAuthProvider.provider verifyPhoneNumberWithMultiFactorInfo:selectedHint UIDelegate:nil multiFactorSession:resolver.session completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) { if (error) { [self showMessagePrompt:error.localizedDescription]; } else { [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Verification code for %@", selectedHint.displayName] completionBlock:^(BOOL userPressedOK, NSString *_Nullable verificationCode) { FIRPhoneAuthCredential *credential = [[FIRPhoneAuthProvider provider] credentialWithVerificationID:verificationID verificationCode:verificationCode]; FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential]; [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (error) { [self showMessagePrompt:error.localizedDescription]; } else { NSLog(@"Multi factor finanlize sign in succeeded."); } }]; }]; } }]; }]; } else if (error) { // ... return; } // User successfully signed in. Get user data from the FIRUser object if (authResult == nil) { return; } FIRUser *user = authResult.user; // ... }];
مراحل بعدی
پساز اینکه کاربر برای اولینبار به سیستم وارد شد، حساب کاربری جدیدی ایجاد میشود و به اطلاعات اعتباری (یعنی نام کاربری و گذرواژه، شماره تلفن، یا اطلاعات ارائهدهنده احراز هویت) که کاربر با آن به سیستم وارد شده است پیوند داده میشود. این حساب جدید بهعنوان بخشی از پروژه Firebase شما ذخیره میشود و میتوان از آن برای شناسایی کاربر در هر برنامه در پروژه شما، صرفنظر از نحوه ورود کاربر به سیستم، استفاده کرد.
-
در برنامههایتان، میتوانید اطلاعات نمایه پایه کاربر را از شیء
Userدریافت کنید. مدیریت کاربران را ببینید. در Firebase Realtime Database و Cloud Storage قوانین امنیتی، میتوانید شناسه کاربر منحصربهفرد کاربر واردشده به سیستم را از متغیر
authدریافت کنید، و از آن برای کنترل دادههایی که کاربر میتواند به آنها دسترسی داشته باشد استفاده کنید.
میتوانید به کاربران اجازه دهید بااستفاده از چند ارائهدهنده اصالتسنجی به سیستم برنامهتان وارد شوند. برای این کار، اعتبارنامههای ارائهدهنده اصالتسنجی را به حساب کاربری موجود پیوند دهید.
برای خارج کردن کاربر از سیستم،
signOut: را فراخوانی کنید.
Swift
let firebaseAuth = Auth.auth() do { try firebaseAuth.signOut() } catch let signOutError as NSError { print("Error signing out: %@", signOutError) }
Objective-C
NSError *signOutError; BOOL status = [[FIRAuth auth] signOut:&signOutError]; if (!status) { NSLog(@"Error signing out: %@", signOutError); return; }
همچنین ممکن است بخواهید کد رسیدگی به خطا را برای طیف کامل خطاهای اصالتسنجی اضافه کنید. رسیدگی به خطاها را ببینید.