Apa yang setara NSLocalizedString di Swift?

Adakah yang setara dengan Swift NSLocalizedString(...)? Dalam Objective-C, kami biasanya menggunakan:

NSString *string = NSLocalizedString(@"key", @"comment");

Bagaimana saya bisa mencapai hal yang sama di Swift? Saya menemukan fungsi:

func NSLocalizedString(
    key: String,
    tableName: String? = default,
    bundle: NSBundle = default,
    value: String = default,
    #comment: String) -> String

Namun, ini sangat panjang dan tidak nyaman sama sekali.

Saya menggunakan solusi berikutnya:

1) buat ekstensi:

extension String {
    var localized: String {
        return NSLocalizedString(self, tableName: nil, bundle: Bundle.main, value: "", comment: "")
    }
}

2) dalam file Localizable.strings :

"Hi" = "Привет";

3) contoh penggunaan:

myLabel.text = "Hi".localized

Nikmati! ;)

--upd: -

untuk kasus dengan komentar Anda dapat menggunakan solusi ini:

1) Perpanjangan:

extension String {
    func localized(withComment:String) -> String {
        return NSLocalizedString(self, tableName: nil, bundle: Bundle.main, value: "", comment: withComment)
    }
}

2) dalam file .strings:

/* with !!! */
"Hi" = "Привет!!!";

3) menggunakan:

myLabel.text = "Hi".localized(withComment: "with !!!")

Yang NSLocalizedStringada juga di dunia Swift.

func NSLocalizedString(
    key: String,
    tableName: String? = default,
    bundle: NSBundle = default,
    value: String = default,
    #comment: String) -> String

The tableName, bundledan valueparameter ditandai dengan defaultkata kunci yang berarti kita dapat menghilangkan parameter ini sementara memanggil fungsi. Dalam hal ini, nilai standarnya akan digunakan.

Ini mengarah pada kesimpulan bahwa pemanggilan metode dapat disederhanakan menjadi:

NSLocalizedString("key", comment: "comment")

Swift 5 - tidak ada perubahan, masih berfungsi seperti itu.

Variasi dari jawaban yang ada:

Swift 5.1:

extension String {

    func localized(withComment comment: String? = nil) -> String {
        return NSLocalizedString(self, comment: comment ?? "")
    }

}

Anda kemudian dapat menggunakannya dengan atau tanpa komentar:

"Goodbye".localized()
"Hello".localized(withComment: "Simple greeting")

Harap dicatat bahwa genstringstidak akan berfungsi dengan solusi ini.

Dengan menggunakan cara ini, dimungkinkan untuk membuat implementasi yang berbeda untuk tipe yang berbeda (yaitu kelas Int atau khusus seperti CurrencyUnit, ...). Anda juga dapat memindai metode ini dengan menggunakan utilitas genstrings. Cukup tambahkan bendera rutin ke perintah

genstrings MyCoolApp/Views/SomeView.swift -s localize -o .

perpanjangan:

import UIKit

extension String {
    public static func localize(key: String, comment: String) -> String {
        return NSLocalizedString(key, comment: comment)
    }
}

pemakaian:

String.localize("foo.bar", comment: "Foo Bar Comment :)")

Versi Swift 3:) ...

import Foundation

extension String {
    var localized: String {
        return NSLocalizedString(self, tableName: nil, bundle: Bundle.main, value: "", comment: "")
    }
}

Sebenarnya, Anda dapat menggunakan dua fase untuk menerjemahkan teks Anda di proyek Swift:

1) Fase pertama menggunakan cara lama untuk membuat semua string Anda yang dapat diterjemahkan:

NSLocalisedString("Text to translate", comment: "Comment to comment")

1.1) Maka Anda harus menggunakan genstring untuk menghasilkan Localizable.strings:

$ genstrings *swift

2) Setelah itu, Anda harus menggunakan jawaban ini .

2.1) Gunakan opsi "Temukan dan Ganti" XCode Anda berdasarkan ekspresi reguler. Adapun contoh yang diberikan (jika Anda tidak memiliki komentar) ekspresi regulernya adalah:

NSLocalizedString\((.*)\, comment:\ \"\"\) 

dan ganti dengan

$1.localized

atau (jika Anda memiliki komentar)

NSLocalizedString\((.*)\, comment:\ (.*)\)

dan ganti dengan

$1.localizedWithComment(comment: $2)

Anda bebas bermain dengan regex dan kombinasi ekstensi yang berbeda sesuai keinginan. Cara umumnya adalah memecah seluruh proses menjadi dua fase. Semoga itu bisa membantu.

Dibuat metode pembantu kecil untuk kasus, di mana "komentar" selalu diabaikan. Lebih sedikit kode lebih mudah dibaca:

public func NSLocalizedString(key: String) -> String {
    return NSLocalizedString(key, comment: "")
}

Letakkan di mana saja (di luar kelas) dan Xcode akan menemukan metode global ini.

Mungkin cara terbaik adalah satu ini di sini .

fileprivate func NSLocalizedString(_ key: String) -> String {
    return NSLocalizedString(key, comment: "")
}

dan

import Foundation
extension String {
    static let Hello = NSLocalizedString("Hello")
    static let ThisApplicationIsCreated = NSLocalizedString("This application is created by the swifting.io team")
    static let OpsNoFeature = NSLocalizedString("Ops! It looks like this feature haven't been implemented yet :(!")
}

Anda dapat menggunakannya seperti ini

let message: String = .ThisApplicationIsCreated
print(message)

bagi saya ini adalah yang terbaik karena

• String hardcoded ada dalam satu file tertentu, jadi hari Anda ingin mengubahnya sangat mudah
• Lebih mudah digunakan daripada mengetik string secara manual di file Anda setiap saat
• genstring masih akan bekerja
• Anda dapat menambahkan lebih banyak ekstensi, seperti satu per tampilan controller untuk menjaga semuanya tetap rapi

Ketika Anda sedang mengembangkan SDK. Anda perlu beberapa operasi tambahan.

1) buat Localizable.strings seperti biasa di YourLocalizeDemoSDK.

2) buat Localizable.strings yang sama di YourLocalizeDemo.

3) temukan Bundle Path Anda dari YourLocalizeDemoSDK.

Swift4 :

// if you use NSLocalizeString in NSObject, you can use it like this
let value = NSLocalizedString("key", tableName: nil, bundle: Bundle(for: type(of: self)), value: "", comment: "")

Bundle(for: type(of: self))membantu Anda menemukan bundel di YourLocalizeDemoSDK. Jika Anda menggunakan Bundle.mainsebagai gantinya, Anda akan mendapatkan nilai yang salah (sebenarnya string itu akan sama dengan kunci).

Tetapi jika Anda ingin menggunakan ekstensi String yang disebutkan oleh dr OX . Anda perlu melakukan lebih banyak lagi. Ekstensi asal terlihat seperti ini.

extension String {
    var localized: String {
        return NSLocalizedString(self, tableName: nil, bundle: Bundle.main, value: "", comment: "")
    }
}

Seperti yang kita ketahui, kami sedang mengembangkan SDK, Bundle.mainakan mendapatkan bundel bundel YourLocalizeDemo. Bukan itu yang kita inginkan. Kami membutuhkan bundel di YourLocalizeDemoSDK. Ini adalah trik untuk menemukannya dengan cepat.

Jalankan kode di bawah ini dalam instance NSObject di YourLocalizeDemoSDK. Dan Anda akan mendapatkan URL YourLocalizeDemoSDK.

let bundleURLOfSDK = Bundle(for: type(of: self)).bundleURL
let mainBundleURL = Bundle.main.bundleURL

Cetak kedua url, Anda akan menemukan bahwa kita dapat membangun bundleURLofSDK berdasarkan mainBundleURL. Dalam hal ini, itu akan menjadi:

let bundle = Bundle(url: Bundle.main.bundleURL.appendingPathComponent("Frameworks").appendingPathComponent("YourLocalizeDemoSDK.framework")) ?? Bundle.main

Dan ekstensi String akan menjadi:

extension String {
    var localized: String {
        let bundle = Bundle(url: Bundle.main.bundleURL.appendingPathComponent("Frameworks").appendingPathComponent("YourLocalizeDemoSDK.framework")) ?? Bundle.main
        return NSLocalizedString(self, tableName: nil, bundle: bundle, value: "", comment: "")
    }
}

Semoga ini bisa membantu.

Saya telah membuat semacam alat alat pstring untuk mengekstraksi string menggunakan fungsi terjemahan khusus

extension String {

    func localizedWith(comment:String) -> String {
        return NSLocalizedString(self, tableName: nil, bundle: Bundle.main, value: "", comment: comment)
    }

}

https://gist.github.com/Maxdw/e9e89af731ae6c6b8d85f5fa60ba848c

Ini akan mem-parsing semua file cepat Anda dan mengekspor string dan komentar dalam kode Anda ke file .strings

Mungkin bukan cara termudah untuk melakukannya, tetapi itu mungkin.

Meskipun ini tidak menjawab masalah pemendekan, tetapi ini membantu saya untuk mengatur pesan, saya membuat struktur untuk pesan kesalahan seperti di bawah ini

struct Constants {
    // Error Messages
    struct ErrorMessages {
        static let unKnownError = NSLocalizedString("Unknown Error", comment: "Unknown Error Occured")
        static let downloadError = NSLocalizedString("Error in Download", comment: "Error in Download")
    }
}

let error = Constants.ErrorMessages.unKnownError

Dengan cara ini Anda dapat mengatur pesan dan membuat genstring berfungsi.

Dan ini adalah perintah genstring yang digunakan

find ./ -name \*.swift -print0 | xargs -0 genstrings -o .en.lproj

Bermanfaat untuk penggunaan dalam unit test:

Ini adalah versi sederhana yang dapat diperluas ke berbagai kasus penggunaan (misalnya dengan penggunaan tableNames).

public func NSLocalizedString(key: String, referenceClass: AnyClass, comment: String = "") -> String 
{
    let bundle = NSBundle(forClass: referenceClass)
    return NSLocalizedString(key, tableName:nil, bundle: bundle, comment: comment)
}

Gunakan seperti ini:

NSLocalizedString("YOUR-KEY", referenceClass: self)

Atau suka ini dengan komentar:

NSLocalizedString("YOUR-KEY", referenceClass: self, comment: "usage description")

Ini merupakan peningkatan pada pendekatan ".localized". Mulailah dengan menambahkan ekstensi kelas karena ini akan membantu dengan string apa pun yang Anda atur secara terprogram:

extension String {
    func localized (bundle: Bundle = .main, tableName: String = "Localizable") -> String {
        return NSLocalizedString(self, tableName: tableName, value: "\(self)", comment: "")
    }
}

Contoh penggunaan untuk string yang Anda atur secara pemrograman:

  override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)

Sekarang file terjemahan storyboard Xcode membuat pengelola file berantakan dan juga tidak menangani pembaruan storyboard dengan baik. Pendekatan yang lebih baik adalah membuat kelas label dasar baru dan menetapkannya untuk semua label papan cerita Anda:

class BasicLabel: UILabel {
    //initWithFrame to init view from code
    override init(frame: CGRect) {
      super.init(frame: frame)
      setupView()
    }

    //initWithCode to init view from xib or storyboard
    required init?(coder aDecoder: NSCoder) {
      super.init(coder: aDecoder)
      setupView()
    }

    //common func to init our view
    private func setupView() {
        let storyboardText = self.text
        text = storyboardText?.localized()
    }
}

Sekarang setiap label yang Anda tambahkan dan berikan default default untuk di storyboard akan secara otomatis diterjemahkan, dengan asumsi Anda telah menyediakan terjemahan untuk itu.

Anda dapat melakukan hal yang sama untuk UIButton:

class BasicBtn: UIButton {
    //initWithFrame to init view from code
    override init(frame: CGRect) {
      super.init(frame: frame)
      setupView()
    }

    //initWithCode to init view from xib or storyboard
    required init?(coder aDecoder: NSCoder) {
      super.init(coder: aDecoder)
      setupView()
    }

    //common func to init our view
    private func setupView() {
        let storyboardText = self.titleLabel?.text
        let lclTxt = storyboardText?.localized()
        setTitle(lclTxt, for: .normal)
    }
}

Ketika Anda menerjemahkan, katakanlah dari bahasa Inggris, di mana frasa sama, ke bahasa lain di mana berbeda (karena jenis kelamin, konjugasi kata kerja atau kemerosotan) bentuk NSString paling sederhana di Swift yang berfungsi dalam semua kasus adalah tiga argumen satu . Misalnya, frasa bahasa Inggris "sebelumnya adalah", diterjemahkan secara berbeda ke bahasa Rusia untuk kasus "berat" ("предыдущ ий был") dan untuk "pinggang" ("предыдущ ая был а ").

Dalam hal ini Anda memerlukan dua terjemahan berbeda untuk satu Sumber (dalam hal alat XLIFF direkomendasikan dalam WWDC 2018). Anda tidak dapat mencapainya dengan dua argumen NSLocalizedString, di mana "sebelumnya" akan sama untuk "kunci" dan terjemahan bahasa Inggris (yaitu untuk nilainya). Satu-satunya cara adalah menggunakan bentuk argumen tiga

NSLocalizedString("previousWasFeminine", value: "previous was", comment: "previousWasFeminine")

NSLocalizedString("previousWasMasculine", value: "previous was", comment: "previousWasMasculine")

di mana kunci ("beforeWasFeminine" dan "priorWasMasculine") berbeda.

Saya tahu bahwa saran umum adalah menerjemahkan frasa sebagai keseluruhan, namun terkadang terlalu memakan waktu dan merepotkan.

Lokalisasi dengan bahasa default:

extension String {
func localized() -> String {
       let defaultLanguage = "en"
       let path = Bundle.main.path(forResource: defaultLanguage, ofType: "lproj")
       let bundle = Bundle(path: path!)

       return NSLocalizedString(self, tableName: nil, bundle: bundle!, value: "", comment: "")
    }
}