Swift框架访问性错误：单例与普通类初始化器不可访问

嘿，这问题我太熟了！你踩的是Swift框架开发里最容易忽略的访问控制坑——Swift代码默认的访问级别是internal，意思是只有当前模块（也就是你的.Framework内部）能访问这些成员，外部项目作为独立模块自然碰不到。下面给你拆解两个问题的解决办法：

一、单例getInstance不可访问的修复 #

你之前写的单例方法没加访问修饰符，默认是internal，外部根本看不到。要让它能被外部调用，得把类本身和获取实例的方法/静态属性都标记为public（如果允许子类继承就用open）：

public class MySingleton {
    // 静态单例实例要设为public
    public static let shared = MySingleton()
    
    // 如果你坚持用getInstance方法，同样要加public
    public static func getInstance() -> MySingleton {
        return shared
    }
    
    // 初始化器设为private，防止外部直接实例化
    private init() {}
}

这样外部项目导入框架后，不管是调用MySingleton.getInstance()还是MySingleton.shared都没问题了。

二、普通类mySDK初始化器不可访问的修复 #

这个问题本质和单例一样：要么你的类是默认的internal，要么初始化器被设成了private/fileprivate。要让外部能实例化这个类，得做两步：

1. 把类本身声明为public
2. 把需要外部调用的初始化器也标记为public

举个例子：

public class MySDK {
    // 公开的初始化器，外部才能调用
    public init() {
        // 你的初始化逻辑
    }
    
    // 其他需要外部调用的方法、属性，也得加public
    public func startService() {
        // 方法实现
    }
}

如果初始化器带参数，对应的属性和初始化器本身都要加public修饰，别漏了。

为啥之前搜解决方案没用？ #

很多Swift单例或者类的教程都是针对单个App项目写的，这种场景下internal完全够用，所以不会特意提框架的访问控制要求。但框架是要给外部模块用的，必须显式给需要暴露的成员加public/open，不然默认的internal会把它们“藏”在框架里。

说白了就是一句话：框架里所有要给外部用的东西，都得主动标上public！

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