Merge pull request #422 from qonversion/kamo/dev-434-custom-localization

Author: SpertsyanKM

android/src/main/kotlin/com/qonversion/flutter/sdk/qonversion_flutter_sdk/NoCodesPlugin.kt

@@ -64,14 +64,15 @@ class NoCodesPlugin(private val messenger: BinaryMessenger, private val context:
         val projectKey = args["projectKey"] as? String ?: return result.noNecessaryDataError()
         val version = args["version"] as? String ?: return result.noNecessaryDataError()
         val source = args["source"] as? String ?: return result.noNecessaryDataError()
+        val locale = args["locale"] as? String
 
         if (projectKey.isNotEmpty()) {
             // Initialize NoCodes Sandwich
             noCodesSandwich = NoCodesSandwich()
 
             noCodesSandwich?.storeSdkInfo(context, source, version)
 
-            noCodesSandwich?.initialize(context, projectKey)
+            noCodesSandwich?.initialize(context, projectKey, null, null, null, locale)
             noCodesSandwich?.setDelegate(this)
             result.success(null)
         } else {
@@ -102,6 +103,11 @@ class NoCodesPlugin(private val messenger: BinaryMessenger, private val context:
         result.success(null)
     }
 
+    fun setLocale(locale: String?, result: Result) {
+        noCodesSandwich?.setLocale(locale)
+        result.success(null)
+    }
+
     // NoCodesEventListener implementation
     override fun onNoCodesEvent(event: NoCodesEventListener.Event, payload: BridgeData?) {
         val eventData = mapOf("payload" to (payload ?: emptyMap<String, Any>()))

android/src/main/kotlin/com/qonversion/flutter/sdk/qonversion_flutter_sdk/QonversionPlugin.kt

@@ -137,6 +137,7 @@ class QonversionPlugin : MethodCallHandler, FlutterPlugin, ActivityAware {
             "initializeNoCodes" -> noCodesPlugin?.initializeNoCodes(args, result)
             "setScreenPresentationConfig" -> noCodesPlugin?.setScreenPresentationConfig(args["config"] as? Map<String, Any>, args["contextKey"] as? String, result)
             "showNoCodesScreen" -> noCodesPlugin?.showNoCodesScreen(args["contextKey"] as? String, result)
+            "setNoCodesLocale" -> noCodesPlugin?.setLocale(args["locale"] as? String, result)
             else -> result.notImplemented()
         }
     }

example/lib/screens/no_codes_screen.dart

@@ -16,13 +16,15 @@ class NoCodesScreen extends StatefulWidget {
 
 class _NoCodesScreenState extends State<NoCodesScreen> {
   final _contextKeyController = TextEditingController(text: 'kamo_test');
+  final _localeController = TextEditingController();
 
   NoCodesPresentationStyle _presentationStyle = NoCodesPresentationStyle.fullScreen;
   bool _animated = true;
 
   @override
   void dispose() {
     _contextKeyController.dispose();
+    _localeController.dispose();
     super.dispose();
   }
 
@@ -53,6 +55,8 @@ class _NoCodesScreenState extends State<NoCodesScreen> {
                 const SizedBox(height: 16),
                 _buildPresentationConfigSection(),
                 const SizedBox(height: 16),
+                _buildLocaleSection(),
+                const SizedBox(height: 16),
                 _buildActionsSection(),
                 const SizedBox(height: 16),
                 _buildEventsSection(appState),
@@ -149,6 +153,36 @@ class _NoCodesScreenState extends State<NoCodesScreen> {
     );
   }
 
+  Widget _buildLocaleSection() {
+    return SectionCard(
+      title: 'Locale',
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.stretch,
+        children: [
+          TextField(
+            controller: _localeController,
+            decoration: const InputDecoration(
+              hintText: 'e.g. en, de, fr',
+              labelText: 'Locale code',
+            ),
+          ),
+          const SizedBox(height: 12),
+          ElevatedButton.icon(
+            onPressed: _setLocale,
+            icon: const Icon(Icons.language),
+            label: const Text('Set Locale'),
+          ),
+          const SizedBox(height: 8),
+          OutlinedButton.icon(
+            onPressed: _resetLocale,
+            icon: const Icon(Icons.refresh),
+            label: const Text('Reset to Device Default'),
+          ),
+        ],
+      ),
+    );
+  }
+
   Widget _buildActionsSection() {
     return SectionCard(
       title: 'Actions',
@@ -246,6 +280,34 @@ class _NoCodesScreenState extends State<NoCodesScreen> {
     }
   }
 
+  void _setLocale() async {
+    final locale = _localeController.text.trim();
+    final localeValue = locale.isEmpty ? null : locale;
+    
+    try {
+      debugPrint('🔄 [NoCodes] Setting locale: $localeValue');
+      await NoCodes.getSharedInstance().setLocale(localeValue);
+      debugPrint('✅ [NoCodes] Locale set');
+      _showSuccess(localeValue != null ? 'Locale set to: $localeValue' : 'Locale reset to device default');
+    } catch (e) {
+      debugPrint('❌ [NoCodes] Failed to set locale: $e');
+      _showError('Failed to set locale: $e');
+    }
+  }
+
+  void _resetLocale() async {
+    try {
+      debugPrint('🔄 [NoCodes] Resetting locale to device default...');
+      await NoCodes.getSharedInstance().setLocale(null);
+      _localeController.clear();
+      debugPrint('✅ [NoCodes] Locale reset');
+      _showSuccess('Locale reset to device default');
+    } catch (e) {
+      debugPrint('❌ [NoCodes] Failed to reset locale: $e');
+      _showError('Failed to reset locale: $e');
+    }
+  }
+
   void _showSuccess(String message) {
     ScaffoldMessenger.of(context).showSnackBar(
       SnackBar(content: Text(message), backgroundColor: AppTheme.successColor),

ios/Classes/NoCodesPlugin.swift

@@ -72,7 +72,8 @@ public class NoCodesPlugin: NSObject {
         }
 
         let proxyUrl = args["proxyUrl"] as? String
-        noCodesSandwich?.initialize(projectKey: projectKey, proxyUrl: proxyUrl)
+        let locale = args["locale"] as? String
+        noCodesSandwich?.initialize(projectKey: projectKey, proxyUrl: proxyUrl, locale: locale)
         result(nil)
     }
 
@@ -102,6 +103,11 @@ public class NoCodesPlugin: NSObject {
         noCodesSandwich?.close()
         result(nil)
     }
+    
+    public func setLocale(_ locale: String?, _ result: @escaping FlutterResult) {
+        noCodesSandwich?.setLocale(locale)
+        result(nil)
+    }
 }
 
 extension NoCodesPlugin: NoCodesEventListener {

ios/Classes/SwiftQonversionPlugin.swift

@@ -168,6 +168,10 @@ public class SwiftQonversionPlugin: NSObject, FlutterPlugin {
     case "showNoCodesScreen":
       noCodesPlugin?.showScreen(args, result)
       return
+      
+    case "setNoCodesLocale":
+      noCodesPlugin?.setLocale(args["locale"] as? String, result)
+      return
 
     default:
       return result(FlutterMethodNotImplemented)

lib/src/internal/constants.dart

@@ -35,6 +35,7 @@ class Constants {
   static const kConfig = 'config';
   static const kVersion = 'version';
   static const kSource = 'source';
+  static const kLocale = 'locale';
 
   // MethodChannel methods names
   static const mInitialize = 'initialize';
@@ -76,6 +77,7 @@ class Constants {
   static const mSetScreenPresentationConfig = 'setScreenPresentationConfig';
   static const mShowNoCodesScreen = 'showNoCodesScreen';
   static const mCloseNoCodes = 'closeNoCodes';
+  static const mSetNoCodesLocale = 'setNoCodesLocale';
 
   // Other constants
   static const skuDetailsPriceRatio = 1000000;

lib/src/internal/nocodes_internal.dart

@@ -37,6 +37,7 @@ class NoCodesInternal implements NoCodes {
       Constants.kVersion: QonversionInternal.sdkVersion,
       Constants.kSource: Constants.sdkSource,
       if (config.proxyUrl != null) Constants.kProxyUrl: config.proxyUrl,
+      if (config.locale != null) Constants.kLocale: config.locale,
     };
     // Initialize is fire-and-forget, errors will be handled in subsequent calls
     _channel.invokeMethod(Constants.mInitializeNoCodes, args).catchError((error) {
@@ -166,6 +167,15 @@ class NoCodesInternal implements NoCodes {
     await _invokeMethod(Constants.mCloseNoCodes);
   }
 
+  @override
+  Future<void> setLocale(String? locale) async {
+    if (Platform.isMacOS) {
+      return;
+    }
+    
+    await _invokeMethod(Constants.mSetNoCodesLocale, {Constants.kLocale: locale});
+  }
+
   /// Invokes a method on the platform channel and converts PlatformException to QonversionException
   Future<dynamic> _invokeMethod(String method, [Map<String, dynamic>? arguments]) async {
     try {

lib/src/nocodes.dart

@@ -100,4 +100,13 @@ abstract class NoCodes {
   /// **Platform Support:** iOS and Android. No-op on macOS.
   Future<void> close();
 
+  /// Set the locale for No-Code screens.
+  /// Use this to override the device locale for the No-Codes SDK.
+  /// Pass null to reset to the device default locale.
+  ///
+  /// **Platform Support:** iOS and Android. No-op on macOS.
+  ///
+  /// [locale] the locale to use (e.g. "en", "de", "fr"), or null to reset to device default.
+  Future<void> setLocale(String? locale);
+
 } 

lib/src/nocodes_config.dart

@@ -2,6 +2,7 @@
 class NoCodesConfig {
   final String projectKey;
   final String? proxyUrl;
+  final String? locale;
 
-  const NoCodesConfig(this.projectKey, {this.proxyUrl});
+  const NoCodesConfig(this.projectKey, {this.proxyUrl, this.locale});
 }

lib/src/nocodes_config_builder.dart

@@ -4,6 +4,7 @@ import 'nocodes_config.dart';
 class NoCodesConfigBuilder {
   final String projectKey;
   String? proxyUrl;
+  String? locale;
 
   NoCodesConfigBuilder(this.projectKey);
 
@@ -16,10 +17,20 @@ class NoCodesConfigBuilder {
     return this;
   }
 
+  /// Set the locale for No-Code screens.
+  /// Use this to override the device locale for the No-Codes SDK.
+  ///
+  /// [locale] the locale to use (e.g. "en", "de", "fr").
+  /// Returns the builder instance for method chaining.
+  NoCodesConfigBuilder setLocale(String locale) {
+    this.locale = locale;
+    return this;
+  }
+
   /// Generate [NoCodesConfig] instance with all the provided configurations.
   ///
   /// Returns the complete [NoCodesConfig] instance.
   NoCodesConfig build() {
-    return NoCodesConfig(projectKey, proxyUrl: proxyUrl);
+    return NoCodesConfig(projectKey, proxyUrl: proxyUrl, locale: locale);
   }
 }