updated localization docs and handling

Author: martinmitrevski

DemoAppSwiftUI/Localizable.strings

@@ -0,0 +1,80 @@
+//
+// Copyright © 2020 Stream.io Inc. All rights reserved.
+//
+
+"channel.name.and" = "and";
+"channel.name.andXMore" = "and %@ more";
+"channel.name.missing" = "NoChannel";
+"channel.item.empty-messages" = "No messages";
+"channel.item.typing-singular" = "is typing ...";
+"channel.item.typing-plural" = "are typing ...";
+
+"channel.no-content.title" = "Let's start chatting";
+"channel.no-content.message" = "How about sending your first message to a friend?";
+"channel.no-content.start" = "Start a chat";
+
+"message.actions.inline-reply" = "Reply";
+"message.actions.thread-reply" = "Thread Reply";
+"message.actions.edit" = "Edit Message";
+"message.actions.copy" = "Copy Message";
+"message.actions.delete" = "Delete Message";
+"message.actions.delete.confirmation-title" = "Delete Message";
+"message.actions.delete.confirmation-message" = "Are you sure you want to permanently delete this message?";
+"message.actions.user-unblock" = "Unblock User";
+"message.actions.user-block" = "Block User";
+"message.actions.user-unmute" = "Unmute User";
+"message.actions.user-mute" = "Mute User";
+"message.actions.resend" = "Resend";
+"message.actions.flag" = "Flag Message";
+"message.actions.flag.confirmation-title" = "Flag Message";
+"message.actions.flag.confirmation-message" = "Do you want to send a copy of this message to a moderator for further investigation?";
+
+"messageList.typingIndicator.typing-unknown" = "Someone is typing";
+
+"message.threads.reply" = "Thread Reply";
+"message.threads.replyWith" = "with %@";
+
+"alert.actions.cancel" = "Cancel";
+"alert.actions.delete" = "Delete";
+"alert.actions.ok" = "Ok";
+"alert.actions.delete-channel-title" = "Delete conversation";
+"alert.actions.delete-channel-message" = "Are you sure you want to delete this conversation?";
+"alert.error.title" = "Something went wrong.";
+"alert.error.message" = "The operation couldn't be completed.";
+
+"message.only-visible-to-you" = "Only visible to you";
+"message.deleted-message-placeholder" = "Message deleted";
+
+"composer.title.edit" = "Edit Message";
+"composer.title.reply" = "Reply to Message";
+"composer.placeholder.message" = "Send a message";
+"composer.placeholder.giphy" = "Search GIFs";
+"composer.checkmark.direct-message-reply" = "Also send as direct message";
+"composer.checkmark.channel-reply" = "Also send in channel";
+"composer.picker.title" = "Choose attachment type: ";
+"composer.picker.file" = "File";
+"composer.picker.media" = "Photo or Video";
+"composer.picker.cancel" = "Cancel";
+
+"composer.suggestions.commands.header" = "Instant Commands";
+"message.sending.attachment-uploading-failed" = "UPLOADING FAILED";
+
+"message.title.online" = "Available";
+"message.title.offline" = "Offline";
+"message.title.group" = "%d members, %d online";
+
+"current-selection" = "%d of %d";
+
+"attachment.max-size-exceeded" = "Attachment size exceed the limit.";
+"dates.time-ago-seconds-plural" = "last seen %d seconds ago";
+"dates.time-ago-seconds-singular" = "last seen just one second ago";
+"dates.time-ago-minutes-singular" = "last seen one minute ago";
+"dates.time-ago-minutes-plural" = "last seen %d minutes ago";
+"dates.time-ago-hours-singular" = "last seen one hour ago";
+"dates.time-ago-hours-plural" = "last seen %d hours ago";
+"dates.time-ago-days-singular" = "last seen one day ago";
+"dates.time-ago-days-plural" = "last seen %d days ago";
+"dates.time-ago-weeks-singular" = "last seen one week ago";
+"dates.time-ago-weeks-plural" = "last seen %d weeks ago";
+"dates.time-ago-months-singular" = "last seen one month ago";
+"dates.time-ago-months-plural" = "last seen %d months ago";

Sources/StreamChatSwiftUI/Appearance.swift

@@ -21,7 +21,7 @@ public class Appearance {
     }
 
     /// Provider for custom localization which is dependent on App Bundle.
-    public var localizationProvider: (_ key: String, _ table: String) -> String = { key, table in
+    public static var localizationProvider: (_ key: String, _ table: String) -> String = { key, table in
         Bundle.streamChatUI.localizedString(forKey: key, value: nil, table: table)
     }
 }

Sources/StreamChatSwiftUI/Generated/L10n.swift

@@ -226,9 +226,9 @@ internal enum L10n {
 // MARK: - Implementation Details
 
 extension L10n {
+
   private static func tr(_ table: String, _ key: String, _ args: CVarArg...) -> String {
-     // TODO: Using using Appearance.default prohibits using Appearance injection
-     let format = Appearance.default.localizationProvider(key, table)
+     let format = Appearance.localizationProvider(key, table)
      return String(format: format, locale: Locale.current, arguments: args)
   }
 }

Sources/StreamChatSwiftUI/Generated/L10n_template.stencil

@@ -68,9 +68,9 @@ import Foundation
 // MARK: - Implementation Details
 
 extension {{enumName}} {
+
   private static func tr(_ table: String, _ key: String, _ args: CVarArg...) -> String {
-     // TODO: Using using Appearance.default prohibits using Appearance injection
-     let format = Appearance.default.localizationProvider(key, table)
+     let format = Appearance.localizationProvider(key, table)
      return String(format: format, locale: Locale.current, arguments: args)
   }
 }

StreamChatSwiftUI.xcodeproj/project.pbxproj

@@ -140,6 +140,7 @@
 		84B288D1274CEDD000DD090B /* GroupNameView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84B288D0274CEDD000DD090B /* GroupNameView.swift */; };
 		84B288D3274D23AF00DD090B /* LoginView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84B288D2274D23AF00DD090B /* LoginView.swift */; };
 		84B288D5274D286500DD090B /* LoginViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84B288D4274D286500DD090B /* LoginViewModel.swift */; };
+		84EDBC37274FE5CD0057218D /* Localizable.strings in Resources */ = {isa = PBXBuildFile; fileRef = 84EDBC36274FE5CD0057218D /* Localizable.strings */; };
 /* End PBXBuildFile section */
 
 /* Begin PBXContainerItemProxy section */
@@ -308,6 +309,7 @@
 		84B288D0274CEDD000DD090B /* GroupNameView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = GroupNameView.swift; sourceTree = "<group>"; };
 		84B288D2274D23AF00DD090B /* LoginView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LoginView.swift; sourceTree = "<group>"; };
 		84B288D4274D286500DD090B /* LoginViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LoginViewModel.swift; sourceTree = "<group>"; };
+		84EDBC36274FE5CD0057218D /* Localizable.strings */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.strings; path = Localizable.strings; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -397,6 +399,7 @@
 				84B288CE274C545900DD090B /* CreateGroupViewModel.swift */,
 				8465FDDC2747A14700AF091E /* CustomComposerAttachmentView.swift */,
 				84335013274BAB15007A1B81 /* ViewFactoryExamples.swift */,
+				84EDBC36274FE5CD0057218D /* Localizable.strings */,
 				8465FCCA27468B7500AF091E /* Info.plist */,
 				8465FCC227468B6A00AF091E /* Assets.xcassets */,
 				8465FBB62746873A00AF091E /* Products */,
@@ -786,6 +789,7 @@
 			buildActionMask = 2147483647;
 			files = (
 				8465FCC627468B6A00AF091E /* Preview Assets.xcassets in Resources */,
+				84EDBC37274FE5CD0057218D /* Localizable.strings in Resources */,
 				8465FCC327468B6A00AF091E /* Assets.xcassets in Resources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;

StreamChatSwiftUI.xcodeproj/project.xcworkspace/xcuserdata/martinmitrevski.xcuserdatad/UserInterfaceState.xcuserstate

@@ -4,16 +4,16 @@ title: Localization
 
 ## Introduction
 
-If you deploy your app to users who speak another language, you'll need to internationalize (localize) it. That means you need to write the app in a way that makes it possible to localize values like text and layouts for each language or locale that the app supports.
+If your app supports multiple languages, the chat SDK has support for localizations. For example, you can add more languages, or you can change translations for the existing texts used throughout the SDK.
 
 ## Adding a new language
 
 1. If you don't have `strings` or `stringsdict` files in your project, add those new files to `Localizable.strings` and `Localizable.stringsdict`.
 2. Next [add new language to the project](https://developer.apple.com/documentation/xcode/adding-support-for-languages-and-regions).
 3. Copy the StreamChatUI localization keys into your `strings` and `stringsdict` files. You can find the latest version [here](https://github.com/GetStream/stream-chat-swift/blob/main/Sources/StreamChatSwiftUI/Resources/en.lproj/).
-4. Set the `localizationProvider` to provide your `AppBundle` instead of `StreamChatSwiftUI` frameworks:
+4. Set the `localizationProvider` to provide your `Bundle` instead of the one provided by `StreamChatSwiftUI` SDK (as early as possible in the App lifecylce, e.g. in the `AppDelegate`):
 ```swift
-Appearance.default.localizationProvider = { key, table in
+Appearance.localizationProvider = { key, table in
     Bundle.main.localizedString(forKey: key, value: nil, table: table)
 }
 ```