Flutter iOS项目集成PhoneNumberKit时Swift编译错误的解决咨询

问题描述 #

Android端运行正常，但iOS编译时触发以下Swift编译器错误：

• Error: Module 'PhoneNumberKit' has no member named 'defaultRegionCode'
• Error: Cannot call value of non-function type 'module'
• Error: Cannot infer contextual base in reference to member 'international'

项目此前可正常编译，无明确代码或配置变更导致该问题。

环境信息 #

• Xcode 15.4
• macOS Sonoma 14.6.1
• Flutter 3.24.1
• PhoneNumberKit 4.0.0
• 依赖包：phone_form_field

已尝试无效操作 #

• 更新所有Flutter依赖
• 执行pod deintegrate && pod install重新安装CocoaPods
• 验证Xcode项目部署目标、Swift版本等配置

解决方案 #

1. 锁定兼容的PhoneNumberKit版本 #

phone_form_field暂未适配PhoneNumberKit 4.0.0的API重构，可在pubspec.yaml中强制指定兼容的旧版本（如3.7.3，为phone_form_field稳定适配的版本）：

dependencies:
  phone_form_field: ^<你的当前使用版本>
  phonenumberskit: 3.7.3  # Flutter端对应原生PhoneNumberKit的依赖包

执行以下命令更新依赖与Pods：

flutter pub get
cd ios
pod deintegrate
pod install

2. 适配PhoneNumberKit 4.0.0 API（无需修改依赖源码） #

若需保留PhoneNumberKit 4.0.0，可在ios/Podfile末尾添加post_install钩子，自动修复API调用：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    next unless target.name == 'phone_form_field'
    target.build_configurations.each do |config|
      # 定位并修改依赖的Swift源码文件
      swift_file = target.source_files.find { |f| f.path.end_with?('PhoneNumberInputFormatter.swift') }
      next unless swift_file
      content = File.read(swift_file)
      # 替换旧API为4.0.0新API
      content = content.gsub("PhoneNumberKit.defaultRegionCode()", "PhoneNumberKit.defaultRegionCode")
      content = content.gsub("PhoneNumberKit()", "PhoneNumberKit.shared")
      content = content.gsub(".international", "PhoneNumberFormat.international")
      File.write(swift_file, content)
    end
  end
end

执行pod install后，钩子会自动修改phone_form_field的iOS端源码，适配新API规范。

3. 确认项目配置兼容性 #

• 在Xcode中打开Runner项目，设置部署目标为iOS 12.0+（PhoneNumberKit 4.0.0最低要求）
• 确认Swift版本设置为5.9+（Xcode 15.4默认支持）

背景说明 #

PhoneNumberKit 4.0.0进行了API重大重构：

• 类方法defaultRegionCode()改为静态属性defaultRegionCode
• 实例化PhoneNumberKit()改为单例PhoneNumberKit.shared
• 枚举值.international改为PhoneNumberFormat.international
  这些变更导致依赖旧API的phone_form_field出现编译错误，上述方案可在不修改依赖包源码的前提下解决问题。

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