構造体

LocalizedStringResource

別のプロセスからアクセスできる、ローカライズ可能な文字列への参照。

iOS 16.0+ iPadOS 16.0+ macOS 13.0+ Mac Catalyst 16.0+

tvOS 16.0+ watchOS 9.0+ visionOS 1.0+ Xcode 14.0+

struct LocalizedStringResource

概観

LocalizedStringResource を使用して、検索を後に延期するローカライズ可能な文字列を提供します。

String.LocalizationValue を受け取るイニシャライザを使用してローカライズされた文字列またはローカライズされた属性付き文字列を作成すると、それらのイニシャライザはローカライズされた文字列をすぐに検索します。後で検索を実行したい場合は、この LocalizedStringResource 型を使用してローカライズ可能な文字列を参照します。次に、ローカリゼーションを実行する必要がある場合は、次のように LocalizedStringResource パラメータを取るイニシャライザから String または AttributedString を作成します。

String: init(localized:) または init(localized:options:)。

AttributedString: init(localized:), init(localized:including:), または init(localized:including:)。

このアプローチにより、ローカライズ可能な文字列を、異なるロケールを使用するかもしれない完全に別個のプロセスに提供できます。たとえば、title と description のプロパティに文字列ではなく LocalizedStringResource を使用する、UserAction というデータモデル型を持つアプリについて考えてみましょう。

public protocol UserAction {
static var title: LocalizedStringResource { get }
static var description: LocalizedStringResource { get }
}

このアプリ (またはその埋め込まれたフレームワークの 1 つ) は、これらの LocalizedStringResource メンバーを使用して、ローカライズされた文字列の検索を延期します。通常、これは XPC 経由で別のプロセスを呼び出すときに発生します。

public func perform(action: UserAction) {
...
// Send text to another process via XPC or similar.
performActionOutOfProcess(title: action.title, description: action.description)
}

その後、他のプロセスが呼び出しを受信すると、ローカライズされた文字列を解決する前に、LocalizedStringResource 内の locale を変更できます。

func performActionOutOfProcess(title: LocalizedStringResource,
description: LocalizedStringResource) {
// Set resource locales to match the current locale
// of the separate process.
var fixedTitle = title
fixedTitle.locale = .current
var fixedDescription = description
fixedDescription.locale = .current
// Look up localized strings.
let titleString = String(localized: fixedTitle)
let descriptionString = String(localized: fixedDescription)
// Use a correctly localized title/description.
}

App Intents (App Intents)フレームワークは LocalizedStringResource を使用して、ローカライズされた文字列の遅延した解決を実行します。これにより、Siri UI は、インテントを提供するアプリとは異なるローカリゼーション設定を使用できる可能性があります。