ручний вибір мови в додатку iOS (iPhone та iPad)

Моє запитання:

Як мій додаток для iPhone може сказати iOS, що користувач вибрав мову в налаштуваннях програм, яка відрізняється від мови, встановленої в загальних налаштуваннях?

Інше формулювання того ж питання:

Як я можу сказати системі, яка NSLocalizedString (@"text", @"comment");повинна мати доступ не до загальновибраної мови, а до вибраної в програмі мови?

фон, приклад:

Візьміть цю ситуацію як приклад: син німецьких іммігрантів живе на північному сході Франції поруч із Люксембургом та Німеччиною. Його рідною мовою є французька, тому він встановив для мови інтерфейсу користувача свого iPhone французьку (Налаштування -> Загальні -> Міжнародні -> Мова -> Французька). Але завдяки своєму культурному походженню та тому, що регіон, де він живе, є двомовним, він також дуже добре володіє німецькою мовою. Але він не говорить десять слів англійською. На iPhone (і iPad також) він не має можливості вибрати другу мову, тому телефон знає лише, що він поширює французьку мову. Він не знає навичок користувачів іншими мовами.

Тепер з’являється мій додаток: я розробив його англійською та німецькою мовами (німецька - моя рідна мова, а англійська - стандартна мова в ІТ). Я розробив його відповідно до всіх правил та найкращих практик для мулілінгвальних iOS-додатків. "Першою" мовою (мовою за замовчуванням) мого додатка є англійська.

Це означає:

Якщо хтось вибрав англійську чи німецьку мову у своїх налаштуваннях, користувальницький інтерфейс програм автоматично використовуватиме вибрану мову. Користувач навіть не помітить, що доступні інші мови.

Але якщо він вибрав будь-яку іншу мову (наприклад, китайську, польську чи французьку) у загальних налаштуваннях, він отримає мову програм за замовчуванням, а це, у моєму випадку, англійська. Але для мого французько-німецького друга це не найкращий вибір. Він хотів би використати існуючу німецьку версію, але, схоже, немає можливості дозволити користувачеві вибрати цю версію.

Додавання французького перекладу вирішить проблему для нашого французько-німецького друга, але не для людей, які говорять на двох інших мовах (наприклад, італійській та німецькій), і я не можу підтримати свій додаток на всіх мовах, на яких розмовляють на цій планеті. Встановлення мови за замовчуванням німецькою також не є оптимальним, оскільки це створює ту саму проблему для людей, які говорять французькою (рідною мовою) та англійською (як другою мовою).

Тому я думаю, що у мого додатка повинна бути можливість вручну вибрати мову, яка відрізняється від попередньо вибраної мови. Додавання вибору мови на панель налаштувань програм не є проблемою. Але як я можу сказати системі, яка NSLocalizedString (@"text", @"comment");повинна мати доступ не до загальновибраної мови, а до вибраної в програмі мови?

Тим часом я все-таки знайшов на собі рішення своєї проблеми:

Я створив новий клас "LocalizeHelper":

Заголовок LocalizeHelper.h

//LocalizeHelper.h

#import <Foundation/Foundation.h>

// some macros (optional, but makes life easy)

// Use "LocalizedString(key)" the same way you would use "NSLocalizedString(key,comment)"
#define LocalizedString(key) [[LocalizeHelper sharedLocalSystem] localizedStringForKey:(key)]

// "language" can be (for american english): "en", "en-US", "english". Analogous for other languages.
#define LocalizationSetLanguage(language) [[LocalizeHelper sharedLocalSystem] setLanguage:(language)]

@interface LocalizeHelper : NSObject

// a singleton:
+ (LocalizeHelper*) sharedLocalSystem;

// this gets the string localized:
- (NSString*) localizedStringForKey:(NSString*) key;

//set a new language:
- (void) setLanguage:(NSString*) lang;              

@end

iMplementation LocalizeHelper.m

// LocalizeHelper.m
#import "LocalizeHelper.h"

// Singleton
static LocalizeHelper* SingleLocalSystem = nil;

// my Bundle (not the main bundle!)
static NSBundle* myBundle = nil;


@implementation LocalizeHelper


//-------------------------------------------------------------
// allways return the same singleton
//-------------------------------------------------------------
+ (LocalizeHelper*) sharedLocalSystem {
    // lazy instantiation
    if (SingleLocalSystem == nil) {
        SingleLocalSystem = [[LocalizeHelper alloc] init];
    }
    return SingleLocalSystem;
}


//-------------------------------------------------------------
// initiating
//-------------------------------------------------------------
- (id) init {
    self = [super init];
    if (self) {
        // use systems main bundle as default bundle
        myBundle = [NSBundle mainBundle];
    }
    return self;
}


//-------------------------------------------------------------
// translate a string
//-------------------------------------------------------------
// you can use this macro:
// LocalizedString(@"Text");
- (NSString*) localizedStringForKey:(NSString*) key {
    // this is almost exactly what is done when calling the macro NSLocalizedString(@"Text",@"comment")
    // the difference is: here we do not use the systems main bundle, but a bundle
    // we selected manually before (see "setLanguage")
    return [myBundle localizedStringForKey:key value:@"" table:nil];
}


//-------------------------------------------------------------
// set a new language
//-------------------------------------------------------------
// you can use this macro:
// LocalizationSetLanguage(@"German") or LocalizationSetLanguage(@"de");
- (void) setLanguage:(NSString*) lang {

    // path to this languages bundle
    NSString *path = [[NSBundle mainBundle] pathForResource:lang ofType:@"lproj" ];
    if (path == nil) {
        // there is no bundle for that language
        // use main bundle instead
        myBundle = [NSBundle mainBundle];
    } else {

        // use this bundle as my bundle from now on:
        myBundle = [NSBundle bundleWithPath:path];

        // to be absolutely shure (this is probably unnecessary):
        if (myBundle == nil) {
            myBundle = [NSBundle mainBundle];
        }
    }
}


@end

Для кожної мови, яку ви хочете підтримувати, вам потрібен файл із іменем Localizable.strings. Це працює точно так, як описано в документації до локалізації Apple. Єдина відмінність: тепер ви навіть можете використовувати такі мови, як хінді чи есперанто, які не підтримуються Apple.

Для прикладу, ось перші рядки моєї англійської та німецької версій Localizable.strings:

Англійська

/* English - English */

/* for debugging */
"languageOfBundle" = "English - English";

/* Header-Title of the Table displaying all lists and projects */
"summary" = "Summary";

/* Section-Titles in table "summary" */
"help" = "Help";
"lists" = "Lists";
"projects" = "Projects";
"listTemplates" = "List Templates";
"projectTemplates" = "Project Templates";

Німецька

/* German - Deutsch */

/* for debugging */
"languageOfBundle" = "German - Deutsch";

/* Header-Title of the Table displaying all lists and projects */
"summary" = "Überblick";

/* Section-Titles in table "summary" */
"help" = "Hilfe";
"lists" = "Listen";
"projects" = "Projekte";
"listTemplates" = "Vorlagen für Listen";
"projectTemplates" = "Vorlagen für Projekte";

Щоб використовувати локалізацію, у вашому додатку повинні бути деякі підпрограми налаштувань та при виборі мови, який ви викликаєте макросом:

LocalizationSetLanguage(selectedLanguage);

Після цього ви повинні переконатися, що все, що відображалося старою мовою, зараз перемальовується новою мовою (приховані тексти повинні бути перемальовані, як тільки вони знову стануть видимими).

Щоб мати доступні локалізовані тексти для будь-якої ситуації, ви НІКОЛИ не повинні писати тексти виправлень до назв об’єктів. ЗАВЖДИ використовуй макрос LocalizedString(keyword).

не:

cell.textLabel.text = @"nice title";

робити:

cell.textLabel.text = LocalizedString(@"nice title");

і мати запис "хороший заголовок" у кожній версії Localizable.strings!

Просто додайте на екран наступне з вибором мови:

    NSString *tempValue = //user chosen language. Can be picker view/button/segmented control/whatever. Just get the text out of it
    NSString *currentLanguage = @"";
    if ([tempValue rangeOfString:NSLocalizedString(@"English", nil)].location != NSNotFound) {
        currentLanguage = @"en";
    } else if ([tempValue rangeOfString:NSLocalizedString(@"German", nil)].location != NSNotFound) {
        currentLanguage = @"de";
    } else if ([tempValue rangeOfString:NSLocalizedString(@"Russian", nil)].location != NSNotFound) {
        currentLanguage = @"ru";
    }
    [[NSUserDefaults standardUserDefaults] setObject:[NSArray arrayWithObjects:currentLanguage, nil] forKey:@"AppleLanguages"];
    [[NSUserDefaults standardUserDefaults]synchronize];

Потім попросіть їх перезапустити програму, і програма буде іншою мовою.

Сподіваюся, це допоможе

Ось готовий до використання і крок за кроком керівництво про те , як використовувати підхід Novarg в Swift 3 :

Крок No1: Застосуйте інструмент вибору мови

Як найкраще це зробити, залежить від вас і залежить від проекту. Але використовуйте

Bundle.main.localizations.filter({ $0 != "Base" }) // => ["en", "de", "tr"]

отримати програмний список усіх підтримуваних мовних кодів мов. Також ви можете використовувати

Locale.current.localizedString(forLanguageCode: "en") // replace "en" with your variable

представити назву мови в поточній мові програм .

Як повний приклад, ви можете представити лист дії з натисканням на кнопку, подібну до цієї:

@IBOutlet var changeLanguageButton: UIButton!

@IBAction func didPressChangeLanguageButton() {
    let message = "Change language of this app including its content."
    let sheetCtrl = UIAlertController(title: "Choose language", message: message, preferredStyle: .actionSheet)

    for languageCode in Bundle.main.localizations.filter({ $0 != "Base" }) {
        let langName = Locale.current.localizedString(forLanguageCode: languageCode)
        let action = UIAlertAction(title: langName, style: .default) { _ in
            self.changeToLanguage(languageCode) // see step #2
        }
        sheetCtrl.addAction(action)
    }

    let cancelAction = UIAlertAction(title: "Cancel", style: .cancel, handler: nil)
    sheetCtrl.addAction(cancelAction)

    sheetCtrl.popoverPresentationController?.sourceView = self.view
    sheetCtrl.popoverPresentationController?.sourceRect = self.changeLanguageButton.frame
    present(sheetCtrl, animated: true, completion: nil)
}

Крок 2: Поясніть користувачеві, що робити + Змініть мову за допомогою перезапуску

Ви могли помітити, що код на кроці 1 викликає метод з іменем changeToLanguage(langCode:). Це те , що ви повинні робити, коли користувач вибирає нову мову, на яку ви хочете змінити, незалежно від того, як ви розробили свій вибір. Ось його реалізація , просто скопіюйте у свій проект:

private func changeToLanguage(_ langCode: String) {
    if Bundle.main.preferredLocalizations.first != langCode {
        let message = "In order to change the language, the App must be closed and reopened by you."
        let confirmAlertCtrl = UIAlertController(title: "App restart required", message: message, preferredStyle: .alert)

        let confirmAction = UIAlertAction(title: "Close now", style: .destructive) { _ in
            UserDefaults.standard.set([langCode], forKey: "AppleLanguages")
            UserDefaults.standard.synchronize()
            exit(EXIT_SUCCESS)
        }
        confirmAlertCtrl.addAction(confirmAction)

        let cancelAction = UIAlertAction(title: "Cancel", style: .cancel, handler: nil)
        confirmAlertCtrl.addAction(cancelAction)

        present(confirmAlertCtrl, animated: true, completion: nil)
    }
}

Це одночасно запитає та повідомить користувача про те, чи він хоче внести зміни, і як це зробити. Також він встановлює мову додатків при наступному запуску використання:

UserDefaults.standard.set([langCode], forKey: "AppleLanguages")
UserDefaults.standard.synchronize() // required on real device

Крок No3 (необов’язково): Локалізуйте рядки

Можливо, ви захочете локалізувати рядки типу "Закрити зараз", використовуючи NSLocalizedStringмакрос (або будь-який інший розширений метод).

Приклад реального світу

Я використовую саме цю реалізацію в додатку, призначеному для iOS 10, я можу підтвердити, що це працює для мене як на симуляторі, так і на пристрої. Додаток насправді є відкритим кодом , тому ви можете знайти вищевказаний код, розподілений по різних класах тут .

Починаючи з iOS 13, тепер існує спосіб встановити окрему мову для кожної програми, що підтримується самою iOS. У програмі Apple Settings відкрийте налаштування певної програми та виберіть мову в розділі "Мова, яку ви бажаєте". Ви можете вибрати мову, яку підтримує програма.

Моя відповідь може бути питанням переваги, оскільки я б зневажав вибір мови вручну в додатку: вам доведеться замінити всі передбачені системою кнопки та не використовувати їх. Це також додає ще один рівень складності і може призвести користувача до плутанини.

Однак, оскільки це має бути відповіддю, я думаю, що ваш варіант використання вирішено без злому мови.

У налаштуваннях iOS ви можете встановити додаткові мови:

Ваш приклад син іммігрантів міг би встановити французьку як основну мову, а німецьку як додаткову.

Тоді, коли ваш додаток буде локалізовано на англійській та німецькій мовах, iPhone цього молодого чоловіка вибере німецькі ресурси.

Це вирішить проблему?

Localize-Swift - зручна локалізація Swift та i18n з перемиканням мови в додатку

Його дуже просто і легко змінити мову вручну. Перш за все, вам потрібно локалізувати програму, а потім ви можете скористатися наведеним нижче кодом для ручної зміни мови у програмі.

UIAlertController *actionSheet = [UIAlertController alertControllerWithTitle:NSLocalizedString(@"App restart required", @"App restart required") message:NSLocalizedString(@"In order to change the language, the App must be closed and reopened by you.", @"In order to change the language, the App must be closed and reopened by you.") preferredStyle:UIAlertControllerStyleActionSheet];

    [actionSheet addAction:[UIAlertAction actionWithTitle:NSLocalizedString(@"Cancel", @"Cancel") style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {


        [self dismissViewControllerAnimated:YES completion:^{


        }];
    }]];

    [actionSheet addAction:[UIAlertAction actionWithTitle:NSLocalizedString(@"Restart", @"Restart") style:UIAlertActionStyleDestructive handler:^(UIAlertAction *action) {

        [[NSUserDefaults standardUserDefaults] setObject:[NSArray arrayWithObjects:@"ar", nil] forKey:@"AppleLanguages"];
        [[NSUserDefaults standardUserDefaults]synchronize];

        exit(EXIT_SUCCESS);


    }]];


    [self presentViewController:actionSheet animated:YES completion:nil];
}

У мене було подібне питання в моєму поточному робочому проекті. Я придумав простий спосіб зробити це, і мені довелося пояснити це своїм партнерам, щоб обговорити рішення. Я створив просту програму з 2 кнопками (англійською || іспанською), щоб вибрати мову всередині програми, код знаходиться в Objective-C (Оскільки наш поточний додаток знаходиться в Objective-C), ось код: https: // bitbucket .org / gastonmontes / gmlanguageselectiondemo