如何为Amplitude创建单例类以实现全局调用？

你可以通过单例模式实现Amplitude的全局复用，只需要在一个文件中完成初始化，其他文件直接调用共享实例即可。以下是两种可行方案：

方案一：扩展Amplitude类添加共享实例 #

在单独的文件（比如AmplitudeExtensions.swift）中定义扩展，创建静态共享实例：

import AmplitudeSwift

extension Amplitude {
    // 懒加载的单例，第一次访问时自动完成初始化
    static let sharedInstance: Amplitude = {
        let config = Configuration(apiKey: "YOUR-API-KEY")
        return Amplitude(configuration: config)
    }()
}

使用方式 #

可在App启动时（可选，提前触发初始化）或任何需要埋点的文件中直接调用：

// 提前初始化（可选，放在AppDelegate/SceneDelegate的启动方法中）
Amplitude.sharedInstance

// 其他文件中调用埋点
Amplitude.sharedInstance.track(eventType: "user_clicked_button")

方案二：封装自定义管理类 #

如果需要添加更多自定义逻辑（比如统一处理用户ID、事件属性），可以封装一个单例管理类：

import AmplitudeSwift

class AmplitudeManager {
    // 全局共享实例
    static let shared = AmplitudeManager()
    
    private let amplitude: Amplitude
    
    // 私有初始化方法，确保只能通过shared获取实例
    private init() {
        let config = Configuration(apiKey: "YOUR-API-KEY")
        amplitude = Amplitude(configuration: config)
    }
    
    // 封装埋点方法
    func track(eventType: String, properties: [String: Any]? = nil) {
        amplitude.track(eventType: eventType, eventProperties: properties)
    }
    
    // 封装设置用户ID的方法
    func setUserId(_ userId: String?) {
        amplitude.setUserId(userId)
    }
}

使用方式 #

在任意文件中调用管理类的方法：

AmplitudeManager.shared.track(eventType: "user_logged_in", properties: ["source": "app"])
AmplitudeManager.shared.setUserId("user_12345")

注意事项 #

• Swift中静态let修饰的单例默认是线程安全的，不用担心多线程初始化问题
• 确保将代码中的YOUR-API-KEY替换为你自己的Amplitude密钥
• 两种方案都只需要初始化一次，避免了重复创建Amplitude实例的冗余操作

内容的提问来源于stack exchange，提问作者Rue Vitale