Swift开发的iOS应用如何对接Google Cloud Functions Logger SDK

重要提示 #

FIRLogger属于FirebaseCore的非公开私有接口，直接调用可能违反Apple审核规则，且Firebase版本更新时大概率会失效。优先推荐使用官方支持的方案（比如Firebase Analytics自定义事件，或直接通过HTTP请求调用Cloud Functions端点），以下内容仅作为临时 workaround，生产环境使用需自行承担风险。

导入步骤 #

1. 配置Objective-C桥接文件
   在项目的桥接文件（如YourProject-Bridging-Header.h）中添加：

   #import <FirebaseCore/FIRLogger.h>
   

   若未创建桥接文件，需在Xcode项目设置中指定路径：进入Build Settings -> Swift Compiler - General -> Objective-C Bridging Header，填入桥接文件的相对路径。

2. 关闭私有API访问警告
   由于调用私有接口会触发Xcode报错，需在Build Settings中调整：

   • 找到Apple Clang - Warning Policies -> Private API Usage，设置为No
   • 或者在Other C Flags中添加-Wno-private-header

Swift代码示例 #

import FirebaseCore

// 封装日志上报方法
func reportLog(toCloud level: FIRLoggerLevel, message: String, category: String) {
    FIRLoggerWrapper.log(withLevel: level,
                         message: message,
                         category: category)
}

// 调用示例
reportLog(toCloud: .info, message: "用户完成登录", category: "Authentication")
reportLog(toCloud: .error, message: "支付请求超时", category: "Payment")

推荐替代方案（无私有API风险） #

直接通过HTTP请求调用Cloud Functions的自定义端点上报日志，示例代码如下：

import Foundation

func sendLogToCloudFunctions(level: String, message: String, category: String) {
    guard let endpointURL = URL(string: "https://your-cloud-function-domain.cloudfunctions.net/receiveLogs") else { return }
    
    var request = URLRequest(url: endpointURL)
    request.httpMethod = "POST"
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    
    let logPayload = [
        "level": level,
        "message": message,
        "category": category,
        "timestamp": Date().timeIntervalSince1970
    ]
    
    do {
        request.httpBody = try JSONSerialization.data(withJSONObject: logPayload)
        let task = URLSession.shared.dataTask(with: request) { _, _, error in
            if let error = error {
                print("日志上报失败: \(error.localizedDescription)")
                return
            }
            print("日志上报成功")
        }
        task.resume()
    } catch {
        print("日志序列化失败: \(error.localizedDescription)")
    }
}

// 调用示例
sendLogToCloudFunctions(level: "INFO", message: "用户完成登录", category: "Authentication")

内容的提问来源于stack exchange，提问作者Andrey Solovyov