Swift环境下未通过CocoaPods添加Firebase框架后无法运行的问题

Hey there! Let’s troubleshoot your Firebase integration issue without CocoaPods—since you’re working in Swift, I’m assuming you went with Swift Package Manager (SPM) (the official recommended approach these days). Here’s a step-by-step breakdown to get things working again:

First, make sure you’ve added Firebase correctly via SPM:

• Open your Xcode project, go to File > Add Packages
• Paste the Firebase SDK repo URL: https://github.com/firebase/firebase-ios-sdk.git
• Select the latest stable version (avoid "main" branch unless you’re testing pre-release features)
• When prompted, select the specific Firebase modules you need (e.g., FirebaseCore, FirebaseAuth, FirebaseFirestore) and link them to your target.
  Pro tip: Don’t just add Firebase—select the exact modules you use to avoid unnecessary bloat.

This is one of the most common points of failure:

• Ensure the plist file you downloaded from the Firebase Console is added to your Xcode project (drag it into the project navigator, and make sure "Copy items if needed" is checked)
• Select the plist file, then in the File Inspector pane, confirm that the Target Membership box is checked for your main app target
• Double-check that the BUNDLE_ID in the plist matches your project’s bundle ID (found in your target’s General settings). Trust me, I’ve wasted hours on a mismatched ID before!

Firebase needs to be configured before any other Firebase calls. Make sure FirebaseApp.configure() runs early in your app’s lifecycle:

• If you’re using AppDelegate, add it in application(_:didFinishLaunchingWithOptions:):

  import UIKit
  import FirebaseCore
  
  @main
  class AppDelegate: UIResponder, UIApplicationDelegate {
      func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
          // Initialize Firebase FIRST
          FirebaseApp.configure()
          // Other setup code comes after
          return true
      }
  }
  

• If you’re using SceneDelegate, add it in scene(_:willConnectTo:options:):

  import UIKit
  import FirebaseCore
  
  class SceneDelegate: UIResponder, UIWindowSceneDelegate {
      var window: UIWindow?
      
      func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
          guard let _ = (scene as? UIWindowScene) else { return }
          FirebaseApp.configure()
      }
  }
  

• In every file where you use Firebase, import the specific module you need (not just Firebase):

  import FirebaseFirestore // For Firestore operations
  import FirebaseAuth      // For authentication
  

• Head to your target’s Build Settings and search for Other Linker Flags—ensure there are no conflicting flags (SPM should handle linking automatically, but manual changes can break things).

Sometimes stale caches cause weird issues:

• Press Command + Shift + K to clean the build folder
• Quit and restart Xcode
• If testing on a simulator, go to Simulator > Device > Erase All Content and Settings; if testing on a physical device, delete the app and reinstall it.

If you’re seeing specific error messages in the Xcode console, use them to narrow down the problem:

• If you see FirebaseApp.configure() was not called, go back to step 3
• If a module is "not found", double-check that you added it via SPM (step 1) and imported it correctly (step 4)

If none of these fix things, drop the exact error message you’re seeing—I can help dig deeper!

内容的提问来源于stack exchange，提问作者Yaseen Khan