Share
Embed
「UIは英語なのにアプリ内リンクは日本語だ!」を防ぐコツ / pixiv App Night 2024-10-24
スマホアプリでは利用規約やプライバシーポリシーなど、静的URLを利用することがよくあります。特に多言語対応したアプリでは端末の言語によってアクセスするURLを変えたい場合がありますが、URLの指定ミスは見た目ではわかりにくく、クラッシュやエラーも発生しないため、問題に気づきにくい課題があります。
この課題を解決するためにString Catalogを利用して静的URLの翻訳を管理し、さらにそれをTestで検証できるようにしたノウハウについてお話します。
FromAtom
October 24, 2024
Transcript
34 slides
-
switch Locale.current.identifier { case "ja_JP": // ຊޠURL case "en_US": //
ӳޠURL default: // ͦͷଞݴޠURL } ύοͱࢥ͍࣮ͭ͘Locale.current • ରԠݴޠ͕૿͑ͨΒʁ • "en_JP" "ja_US" ʁ -
enum ExternalStaticLinks: String, CaseIterable, Sendable { case helpPage = "HelpPageURL"
public var localizationValue: String.LocalizationValue { .init(rawValue) } public var url: URL { .init(string: urlString)! } public var urlString: String { .init(localized: localizationValue) } } let url = ExternalStaticLinks.helpPage.url -
enum SupportLanguages: String, CaseIterable { case en = "en" case
ja = "ja" var bundle: Bundle? { guard let path = Bundle.main.path(forResource: rawValue, ofType: "lproj") else { return nil } return Bundle(path: path) } } final class LinkLocalizeSampleTests: XCTestCase { func test_HelpページのURLが全言語で想定通りに返ってくる() throws { let localizationValue = ExternalStaticLinks.helpPage.localizationValue for lang in SupportLanguages.allCases { let urlString = String(localized: localizationValue, bundle: lang.bundle) switch lang { case .en: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-english") case .ja: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-japanese") } XCTAssertNotNil(URL(string: urlString)) } } } -
enum SupportLanguages: String, CaseIterable { case en = "en" case
ja = "ja" var bundle: Bundle? { guard let path = Bundle.main.path(forResource: rawValue, ofType: "lproj") else { return nil } return Bundle(path: path) } } final class LinkLocalizeSampleTests: XCTestCase { func test_HelpページのURLが全言語で想定通りに返ってくる() throws { let localizationValue = ExternalStaticLinks.helpPage.localizationValue for lang in SupportLanguages.allCases { let urlString = String(localized: localizationValue, bundle: lang.bundle) switch lang { case .en: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-english") case .ja: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-japanese") } XCTAssertNotNil(URL(string: urlString)) } } } -
enum SupportLanguages: String, CaseIterable { case en = "en" case
ja = "ja" var bundle: Bundle? { guard let path = Bundle.main.path(forResource: rawValue, ofType: "lproj") else { return nil } return Bundle(path: path) } } final class LinkLocalizeSampleTests: XCTestCase { func test_HelpページのURLが全言語で想定通りに返ってくる() throws { let localizationValue = ExternalStaticLinks.helpPage.localizationValue for lang in SupportLanguages.allCases { let urlString = String(localized: localizationValue, bundle: lang.bundle) switch lang { case .en: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-english") case .ja: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-japanese") } XCTAssertNotNil(URL(string: urlString)) } } } // => HelpPageURL -
enum SupportLanguages: String, CaseIterable { case en = "en" case
ja = "ja" var bundle: Bundle? { guard let path = Bundle.main.path(forResource: rawValue, ofType: "lproj") else { return nil } return Bundle(path: path) } } final class LinkLocalizeSampleTests: XCTestCase { func test_HelpページのURLが全言語で想定通りに返ってくる() throws { let localizationValue = ExternalStaticLinks.helpPage.localizationValue for lang in SupportLanguages.allCases { let urlString = String(localized: localizationValue, bundle: lang.bundle) switch lang { case .en: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-english") case .ja: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-japanese") } XCTAssertNotNil(URL(string: urlString)) } } } -
enum SupportLanguages: String, CaseIterable { case en = "en" case
ja = "ja" var bundle: Bundle? { guard let path = Bundle.main.path(forResource: rawValue, ofType: "lproj") else { return nil } return Bundle(path: path) } } final class LinkLocalizeSampleTests: XCTestCase { func test_HelpページのURLが全言語で想定通りに返ってくる() throws { let localizationValue = ExternalStaticLinks.helpPage.localizationValue for lang in SupportLanguages.allCases { let urlString = String(localized: localizationValue, bundle: lang.bundle) switch lang { case .en: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-english") case .ja: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-japanese") } XCTAssertNotNil(URL(string: urlString)) } } } -
enum SupportLanguages: String, CaseIterable { case en = "en" case
ja = "ja" var bundle: Bundle? { guard let path = Bundle.main.path(forResource: rawValue, ofType: "lproj") else { return nil } return Bundle(path: path) } } final class LinkLocalizeSampleTests: XCTestCase { func test_HelpページのURLが全言語で想定通りに返ってくる() throws { let localizationValue = ExternalStaticLinks.helpPage.localizationValue for lang in SupportLanguages.allCases { let urlString = String(localized: localizationValue, bundle: lang.bundle) switch lang { case .en: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-english") case .ja: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-japanese") } XCTAssertNotNil(URL(string: urlString)) } } } default: Θͳ͍ -
enum SupportLanguages: String, CaseIterable { case en = "en" case
ja = "ja" var bundle: Bundle? { guard let path = Bundle.main.path(forResource: rawValue, ofType: "lproj") else { return nil } return Bundle(path: path) } } final class LinkLocalizeSampleTests: XCTestCase { func test_HelpページのURLが全言語で想定通りに返ってくる() throws { let localizationValue = ExternalStaticLinks.helpPage.localizationValue for lang in SupportLanguages.allCases { let urlString = String(localized: localizationValue, bundle: lang.bundle) switch lang { case .en: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-english") case .ja: XCTAssertEqual(urlString, "https://sites.google.com/view/url-l18n-demo/help-japanese") } XCTAssertNotNil(URL(string: urlString)) } } } -
func test_ExternalStaticLinksを増減させたのにテストを修正していない時におちる() throws { // NOTE: - ここの数字を変えるだけでなくて、下記のテストを適切に修正すること XCTAssertEqual(ExternalStaticLinks.allCases.count, 11)
} ※1: URLΛ1ͭফͯ͠ɺ1ͭ૿ͨ͠ͱ͖ʹ͔Βͳ͍ ※2: ݫີʹΔͳΒCIͰΧόϨοδ͕Լͨ͠ΒΞϥʔτΛग़͢ -
func test_想定している全言語の翻訳に対応している() throws { for lang in SupportLanguages.allCases { XCTAssertNotNil(lang.bundle,
"Application not translated in \(lang.longName)") } }