Kotlin Multiplatform库typealias类方法访问异常及解决咨询

场景复现 #

你在Kotlin Multiplatform库中使用typealias映射第三方库的类：

import io.michaelrocks.libphonenumber.android.Phonenumber.PhoneNumber

actual typealias PhoneNumber = PhoneNumber

在Android项目测试时，尝试创建该别名对应的对象，编译器抛出错误：
Constructor of inner class PhoneNumber can be called only with receiver of containing class

问题原因 #

• io.michaelrocks.libphonenumber.android.Phonenumber.PhoneNumber是内部类（inner class），而非顶级类或静态嵌套类。内部类的实例化必须依赖外部类Phonenumber的实例作为接收器。
• typealias仅为原类创建了别名，并未改变原类的内部类特性，直接通过别名创建对象时，编译器仍要求提供外部类实例，因此触发报错。

解决方法 #

方法1：使用库提供的标准方式创建实例 #

libphonenumber官方推荐通过PhoneNumberUtil工具类来解析生成PhoneNumber实例，而非直接调用构造方法：

val phoneNumberUtil = PhoneNumberUtil.getInstance()
// 示例：解析手机号，第二个参数为区域码（可传null）
val phoneNumber = phoneNumberUtil.parse("+1234567890", null)

方法2：手动提供外部类实例（不推荐） #

若必须手动创建内部类实例，需先实例化外部类Phonenumber，再通过其创建PhoneNumber：

val phonenumberInstance = Phonenumber()
val phoneNumber = phonenumberInstance.PhoneNumber()

方法3：封装KMM库API（推荐） #

避免直接对外暴露内部类的typealias，在KMM库中封装一层Wrapper类，隐藏内部实现细节：

// commonMain 预期接口
expect class PhoneNumberWrapper {
    fun getNationalNumber(): String
    // 按需添加其他业务需要的方法
}

expect object PhoneNumberHelper {
    fun parsePhoneNumber(number: String, region: String?): PhoneNumberWrapper
}

// androidMain 实际实现
actual class PhoneNumberWrapper(private val internalNumber: PhoneNumber) {
    actual fun getNationalNumber(): String {
        return internalNumber.nationalNumber.toString()
    }
}

actual object PhoneNumberHelper {
    actual fun parsePhoneNumber(number: String, region: String?): PhoneNumberWrapper {
        val util = PhoneNumberUtil.getInstance()
        val internalNumber = util.parse(number, region)
        return PhoneNumberWrapper(internalNumber)
    }
}

上层Android项目直接使用PhoneNumberHelper和PhoneNumberWrapper即可，无需关心内部类的实例化逻辑。

内容的提问来源于stack exchange，提问作者Anmol Singh Sahi