SwiftUI中Swift Package字符串本地化问题及配置咨询

1. 正确配置Swift Package以支持字符串本地化 #

• 确保本地化资源文件（Localizable.xcstrings或.lproj目录）放在Package的Sources/[TargetName]目录下（例如Sources/TestPackage），Xcode会自动识别该路径下的本地化资源。
• 修正Package.swift配置，重点处理资源和默认本地化设置：

  import PackageDescription
  
  let package = Package(
      name: "TestPackage",
      defaultLocalization: "en", // 指定默认语言
      platforms: [.iOS(.v16)],
      products: [
          .library(name: "TestPackage", targets: ["TestPackage"])
      ],
      targets: [
          .target(
              name: "TestPackage",
              resources: [
                  .process("Localizable.xcstrings") // 用process处理，Xcode会自动整理本地化目录结构
              ]
          )
      ]
  )
  

• 若使用传统.lproj目录，资源配置可改为.process(".")，但推荐使用xcstrings（Xcode 15+），它更高效且支持可视化编辑。

2. 本地化SwiftUI中Text视图外部声明的字符串 #

核心问题：直接用String(localized:)初始化的字符串是静态值，初始化时就绑定了当前系统locale，无法随SwiftUI环境的locale动态变化；而Text接收字符串字面量时，Swift会自动推断为LocalizedStringKey，结合bundle动态获取对应语言内容。

方案一：使用LocalizedStringKey类型 #

将外部字符串声明为LocalizedStringKey而非普通String，并在Text中指定Package的bundle：

import SwiftUI

struct SwiftUIViewForPreviews: View {
    // 声明为LocalizedStringKey类型
    let stringFromCurrentView: LocalizedStringKey = "String Example"
    
    var body: some View {
        VStack {
            Text("String Example", bundle: .module) // 原有正常逻辑
            Text(stringFromCurrentView, bundle: .module) // 现在支持本地化
            Text(Strings.stringOneLocalized, bundle: .module) // 修正后支持本地化
        }
    }
}

#Preview {
    SwiftUIViewForPreviews().environment(\.locale, .init(identifier: "de"))
}

public struct Strings {
    // 返回LocalizedStringKey而非String
    public static let stringOneLocalized: LocalizedStringKey = "String Example"
}

方案二：使用LocalizedStringResource（Xcode 15+推荐） #

LocalizedStringResource是专门为本地化设计的类型，原生支持动态响应locale变化：

public struct Strings {
    public static let stringOneLocalized = LocalizedStringResource("String Example", bundle: .module)
}

// View中直接调用
Text(Strings.stringOneLocalized)

方案三：动态响应环境locale（非View场景） #

如果需要在ViewModel等非View场景下获取动态本地化字符串，可结合Environment的locale和bundle：

struct SomeViewModel {
    @Environment(\.locale) private var locale
    
    func getLocalizedString() -> String {
        NSLocalizedString("String Example", bundle: .module, comment: "", locale: locale)
    }
}

3. 在主项目中正确显示Swift Package的本地化字符串 #

核心问题：.module是Swift Package的internal属性，主项目无法直接访问；且主项目调用字符串字面量时，会优先查找自身的本地化资源，而非Package的。

步骤1：在Package中暴露公共Bundle入口 #

在Package的任意公共源码文件中添加：

// 供主项目访问的公共Bundle
public let TestPackageBundle = Bundle.module

步骤2：主项目中指定Package的Bundle调用 #

import SwiftUI
import TestPackage

struct ContentView: View {
    var body: some View {
        VStack {
            // 方式1：结合公共Bundle和LocalizedStringKey
            Text("String Example", bundle: TestPackageBundle)
            
            // 方式2：使用Package封装的LocalizedStringResource
            Text(Strings.stringOneLocalized)
            
            // 方式3：使用Package封装的专用Text视图（可选，简化调用）
            PackageText("String Example")
        }
    }
}

#Preview {
    ContentView().environment(\.locale, .init(identifier: "de"))
}

// 可选：在Package中封装专用Text视图，避免主项目重复指定bundle
public struct PackageText: View {
    let key: LocalizedStringKey
    
    init(_ key: LocalizedStringKey) {
        self.key = key
    }
    
    var body: some View {
        Text(key, bundle: .module)
    }
}

额外注意事项 #

• 确保主项目的Info.plist中添加了需要支持的语言（例如德语de），否则即使Package有对应本地化资源，主项目也不会加载。
• 清理Xcode缓存（Product > Clean Build Folder）并重启Xcode，避免资源缓存导致的异常。

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