Google Sign-In for iOS and macOS

You can explore the implementation details by running the provided sample projects. There are samples available for both Objective-C and Swift.

To run the Objective-C sample using CocoaPods:

1. Clone the repository.
2. Navigate to the Objective-C sample directory.
3. Run pod install.
4. Open the generated .xcworkspace file.

To run the Objective-C sample using Swift Package Manager:

1. Clone the repository.
2. Open the .xcodeproj file directly in Xcode.

For a Swift-specific example, refer to the DaysUntilBirthday sample.

# Using CocoaPods
git clone https://github.com/google/GoogleSignIn-iOS
cd GoogleSignIn-iOS/Samples/ObjC/SignInSample/
pod install
open SignInSampleForPod.xcworkspace

# Using Swift Package Manager
git clone https://github.com/google/GoogleSignIn-iOS
open GoogleSignIn-iOS/Samples/ObjC/SignInSample/SignInSample.xcodeproj

The sample app requires a web API key and a debug token (used for local simulator testing via AppCheckCore).

Local Development

Secrets can be managed using an .xcconfig file. The project uses a placeholder file located at Secrets/AppCheckDefaultSecrets.xcconfig. You can add your API key to this file, but ensure it is not committed to your repository.

Continuous Integration (CI)

In CI environments, AppCheckSecretReader.swift is used to retrieve secrets from environment variables. You should provide these values to your xcodebuild command.

To set up the sample app using CocoaPods, navigate to the ../Samples/Swift/AppAttestExample/ directory, install the dependencies, and open the workspace.

```bash
cd ../Samples/Swift/AppAttestExample/
pod install
open AppAttestExample.xcworkspace

After opening the workspace, run the AppAttestExampleForPod target.

To set up the DaysUntilBirthday sample app using CocoaPods, navigate to the ../Samples/Swift/DaysUntilBirthday/ directory, install the dependencies, and open the workspace.

1. Run pod install.
2. Open DaysUntilBirthdayForPod.xcworkspace.
3. Run either the DaysUntilBirthdayForPod (iOS) or DaysUntilBirthdayForPod (macOS) target.

pod install
open DaysUntilBirthdayForPod.xcworkspace

To set up the DaysUntilBirthday sample app using Swift Package Manager, open the Xcode project directly.

1. Open DaysUntilBirthday.xcodeproj.
2. Run either the DaysUntilBirthday (iOS) or DaysUntilBirthday (macOS) target.

open DaysUntilBirthday.xcodeproj

To set up the Google Sign-In sample project using CocoaPods, navigate to the ../Samples/ObjC/SignInSample/ directory, install the required dependencies, and open the generated workspace.

cd ../Samples/ObjC/SignInSample/
pod install
open SignInSampleForPod.xcworkspace

When building for macOS or using Mac Catalyst, you must configure Keychain Access Groups to ensure credentials can be stored correctly.

Requirements:

• Add $(AppIdentifierPrefix)$(CFBundleIdentifier) as the first item in your app's keychain access group.

Important Note on Credential Removal: Google Sign-In removes keychain items upon a fresh install to prevent stale credentials from being used. If you use a shared access group, a new install might accidentally remove credentials for other apps sharing that group. To prevent this, explicitly list your app's specific default access group (e.g., $(AppIdentifierPrefix)$(CFBundleIdentifier)) as the first item in your list.

To set up the Google Sign-In sample project using Swift Package Manager, open the .xcodeproj file in the ../Sample/ObjC/SignInSample/ directory and run the 'SignInSample' target.

open ../Sample/ObjC/SignInSample/SignInSample.xcodeproj

To set up the sample app using Swift Package Manager, open the project file directly and run the primary target.

```bash
cd ../Samples/Swift/AppAttestExample/
open AppAttestExample.xcodeproj

After opening the project, run the AppAttestExample target.

The integration tests for the DaysUntilBirthday(iOS) sample app require a Google account (email and password) to attempt a login.

Via Xcode

1. Select Edit Scheme > Run > Environment Variables.
2. Add EMAIL_SECRET and PASSWORD_SECRET with your test account credentials.
3. Alternatively, you can edit Credential.swift directly (but do not check these credentials into version control).

Via Command Line

Pass the credentials as environment variables to the xcodebuild command:

xcodebuild <other args> EMAIL_SECRET=... PASSWORD_SECRET=...