江湖数字化平台
登录

多应用配置

12147

什么是多应用配置

多应用配置是指在同一个Flutter项目中，可以配置多个Android或iOS应用程序的不同设置和属性，以便为每个应用程序创建不同的应用程序ID、应用程序名称、应用程序图标等。

它允许开发人员在同一个Flutter项目中创建多个应用程序，而不必为每个应用程序单独创建一个新项目。这样做可以减少代码重复和维护成本，并且可以更快地开发和部署多个应用程序。

此外，使用Flutter的多应用配置还可以为不同的应用程序创建不同的主题、语言、字体等自定义设置。这意味着开发人员可以更轻松地为不同的用户群体创建不同的应用程序。

Flutter的多应用配置

多应用配置

在 /jianghuAppBrowser/jianghuBrowser/lib/main.dart 中配置。

主要包含以下配置：

  1. "backgroundNotice": {   //手机通知栏是否开启
  2.   "org.fsll.duoxing5": false,
  3.   "org.fsll.jianghu3": false,
  4. },
  5. "openSocket": {   //是否打开Socket （在我们的项目中，使用的webSocket）
  6.   "org.fsll.duoxing5": false,
  7.   "org.fsll.jianghu3": false,
  8. },
  9. "openBottomBar": {  //地址栏是否显示，默认都显示
  10.   "org.fsll.duoxing5": true,
  11.   "org.fsll.jianghu3": true,
  12. },
  13. "defaultIcons": {  //icon
  14.   "org.fsll.duoxing5": "assets/logos/dx5_launcher.png",
  15.   "org.fsll.jianghu3": "assets/logos/jianghu_launcher.png",
  16. },
  17. "defaultHost": {  //webview url
  18.   "org.fsll.duoxing5": "https://md.jhdx.org/",
  19.   "org.fsll.jianghu3": "https://www.jianghu03.com/",
  20. },
  21. "primaryColor": {   //主题色
  22.   "org.fsll.duoxing5": const Color(0xFF00579c),
  23.   "org.fsll.jianghu3": const Color(0xFFff5300),
  24. },
  25. "resolverJsons": {  //加密后的域名，需通过接口获取到域名信息，然后解密，会覆盖defaultHost配置
  26.   "org.fsll.duoxing5": [
  27.     "https://md20211227-1301849697.cos.accelerate.myqcloud.com/duoxing_v5.json",
  28.     "https://md-20220505.oss-accelerate.aliyuncs.com/duoxing_v5.json"
  29.   ],
  30.   "org.fsll.jianghu3": [
  31.     'https://md20211227-1301849697.cos.accelerate.myqcloud.com/jianghu_v3.json',
  32.     'https://md-20220505.oss-accelerate.aliyuncs.com/jianghu_v3.json'
  33.   ],
  34. },
  35. "appIds": {   //appId
  36.   "org.fsll.duoxing5": "duoxing",
  37.   "org.fsll.jianghu3": "jianghu3",
  38. },
  39. "appName": {  //app名称
  40.   "org.fsll.duoxing5": "多星5",
  41.   "org.fsll.jianghu3": "江湖3",
  42. },

resolverJsons 获取与解密的逻辑参考 /jianghuAppBrowser/jianghuBrowser/lib/Utils/ResolverListUtil.dart
主要逻辑如下：

  1. static Future<void> checkAndApplyConfig(context, int index, {onError, onDone}) async {
  2.   if (Constants.isIosDev) {
  3.     RenderKey.hostUrl.value = Constants.config.defaultHost['${Constants.packageInfo.packageName}.dev'];
  4.     Constants.defaultHostUrl = RenderKey.hostUrl.value;
  5.     RenderKey.urlEditController.text = RenderKey.hostUrl.value!;
  6.   } else if (Constants.packageInfo.packageName.endsWith('.dev')) {
  7.     RenderKey.hostUrl.value = Constants.config.defaultHost[Constants.packageInfo.packageName];
  8.     Constants.defaultHostUrl = RenderKey.hostUrl.value;
  9.     RenderKey.urlEditController.text = RenderKey.hostUrl.value!;
  10.   } else if(Constants.resolverList.isEmpty) {
  11.     RenderKey.hostUrl.value = Constants.config.defaultHost[Constants.packageInfo.packageName];
  12.     Constants.defaultHostUrl = RenderKey.hostUrl.value;
  13.     RenderKey.urlEditController.text = RenderKey.hostUrl.value!;
  14.   } else {
  15.     await ResolverListUtil.checkResolverConfig(context);
  16.   }
  18.   if (RenderKey.hostUrl.value != null) {
  19.     debugPrint(" ==== Success Url");
  20.     loadNewUrl(onDone);
  21.   }
  22. }
  24. static Future<void> checkResolverConfig(context) async {
  25.   List<String?> resolverListEncode = await getConfigFromResolverList();
  26.   if(resolverListEncode.isEmpty) {
  27.     return;
  28.   }
  29.   String? newEncodedConfig = getMergedConfig(resolverListEncode: resolverListEncode);
  30.   await replaceConfig(newEncodedConfig: newEncodedConfig);
  31. }
  33. static String? getMergedConfig({required List<String?> resolverListEncode}) {
  34.   if (resolverListEncode[0] != null && resolverListEncode[1] != null && resolverListEncode[0] == resolverListEncode[1]) {
  35.     return resolverListEncode[1]!;
  36.   }
  37.   if (resolverListEncode[0] != null && resolverListEncode[1] != null && resolverListEncode[0] != resolverListEncode[1]) {
  38.     return null;
  39.   }
  40.   if (resolverListEncode[0] != null && resolverListEncode[1] == null) {
  41.     return resolverListEncode[0]!;
  42.   }
  43.   if (resolverListEncode[0] == null && resolverListEncode[1] != null) {
  44.     return resolverListEncode[1]!;
  45.   }
  46.   if (resolverListEncode[0] == null && resolverListEncode[1] == null) {
  47.     return null;
  48.   }
  49.   return null;
  50. }
  52. static Future<void> replaceConfig({String? newEncodedConfig}) async {
  53.   if (newEncodedConfig != null) {
  54.     String newDecodedConfig = Utils.decrypt(newEncodedConfig);
  55.     Map newDecodedConfigJson = json.decode(Uri.decodeFull(newDecodedConfig));
  56.     Constants.defaultHostUrl = newDecodedConfigJson['serviceUrl'];
  57.     RenderKey.hostUrl.value = newDecodedConfigJson['serviceUrl'];
  58.     RenderKey.urlEditController.text = RenderKey.hostUrl.value!;
  59.     return;
  60.   }
  61.   RenderKey.hostUrl.value = Constants.config.defaultHost[Constants.packageInfo.packageName]!;
  62. }
  64. /// 获取线上域名密文JSON信息
  65. static Future<List<String?>> getConfigFromResolverList() async {
  66.   List<String?> resolverEncode = [];
  67.   await Future.forEach(Constants.resolverList, (resolver) async {
  68.     debugPrint("resolver $resolver");
  69.     try {
  70.       Response response = await DioUtil.dioClient.get("$resolver?random=${Random().nextInt(9999)}");
  71.       debugPrint("response: ${response.data}");
  72.       resolverEncode.add(response.data['token']);
  73.     } catch (error) {
  74.       resolverEncode.add(null);
  75.     }
  76.   });
  77.   return resolverEncode;
  78. }

多应用配置初始化

在 /jianghuAppBrowser/jianghuBrowser/lib/layout/JianghuConfigHandler.dart 的init方法中，对多应用配置做了处理。

  1. Future<void> init(JianghuConfigEntity config) async {
  2.   Constants.config = config;
  3.   if (!Constants.isBrowser) Constants.appId.value = config.appIds[Constants.packageInfo.packageName]!;
  4.   if (!Constants.isBrowser) Constants.defaultAppId = Constants.appId.value;
  5.   openBottomBar = config.openBottomBar[Constants.packageInfo.packageName]!;
  6.   backgroundNotice = config.backgroundNotice[Constants.packageInfo.packageName]!;
  7.   openSocket = config.openSocket[Constants.packageInfo.packageName]!;
  8.   setPrimaryColor();
  9.   if (!Constants.isBrowser) Constants.resolverListEnv = config.resolverJsons;
  10.   Constants.appName = config.appName[Constants.packageInfo.packageName]!;
  11. }
  13. void setPrimaryColor() {
  14.   if (Constants.config.primaryColor != null) {
  15.     Constants.primaryColor = (Constants.config.primaryColor![Constants.packageInfo.packageName] ?? const Color(0xFFFFFFFF));
  16.   } else {
  17.     Constants.primaryColor = const Color(0xFFFFFFFF);
  18.   }
  19. }

安卓端的多应用配置

可以在Flutter项目中为不同的安卓应用程序定义不同的配置。

图标的配置

  • 图标的生成

可以访问 图标工厂，上传jpg/png/psd文件，即可同时生成 iOS、Android 和 PhoneGap
 应用的图标。遵循 Apple、 Google 官方标准。支持自定义大小、自动圆角、角标和徽章等。支持 Web App, iWatch 等更多平台。快速预览将要在不同设备上显示的应用图标，无需部署即可通过预览来调整设计样式。

  • 图标的使用

将生成的图标复制到 /jianghuAppBrowser/jianghuBrowser/android/app/src/main/res 目录下，并在 /jianghuAppBrowser/jianghuBrowser/android/app/build.gradle 中配置图标路径。具体配置方法请参考下文。

应用参数配置

应用参数在 /jianghuAppBrowser/jianghuBrowser/android/app/build.gradle 中配置。

android.defaultConfig定义默认配置，android.productFlavors定义多应用配置。如果要开启多应用配置，需要在android.defaultConfig.flavorDimensions 中开启。android.productFlavors.dimension的值要与android.defaultConfig.flavorDimensions的值一致。如果不配置android.defaultConfig.flavorDimensions，则默认不开启多应用模式，android.productFlavors中的配置无效，会默认使用android.defaultConfig的配置。

默认配置：

  1. android {
  2.     defaultConfig {
  3.         applicationId "org.fsll.jianghu_browser"
  4.         minSdkVersion 24
  5.         targetSdkVersion 33
  6.         versionCode flutterVersionCode.toInteger()
  7.         versionName flutterVersionName
  8.         flavorDimensions 'jianghu_browser'  //开启多应用配置
  9.     }
  10. }

多应用配置：

  1. android {
  2.     //应用签名配置
  3.     signingConfigs {
  4.         browser {
  5.             storeFile file('./browser.jks')
  6.             storePassword '123456'
  7.             keyAlias 'browser'
  8.             keyPassword '123456'
  9.         }
  10.         duoxing {
  11.             storeFile file('./duoxing5.jks')
  12.             storePassword '123456'
  13.             keyAlias 'duoxing5'
  14.             keyPassword '123456'
  15.         }
  16.         jianghu3 {
  17.             storeFile file('./jianghu3.jks')
  18.             storePassword '123456'
  19.             keyAlias 'jianghu3'
  20.             keyPassword '123456'
  21.         }
  22.     },
  23.     //多应用配置
  24.     productFlavors {
  25.         browser {
  26.             applicationId "org.fsll.browser"
  27.             resValue "string", "app_name", "江湖浏览器"
  28.             resValue "string", "icon", "@mipmap/browser_launcher"   //图标在/jianghuAppBrowser/jianghuBrowser/android/app/src/main/res目录下的mipmap-xxx
  29.             resValue "string", "service_name", "browser_service"
  30.             resValue "string", "screen", "@drawable/screen"     //启动屏图片，在/jianghuAppBrowser/jianghuBrowser/android/app/src/main/res目录下的drawable-xxx
  31.             resValue "color", "primary", "#FFFFFFFF"
  32.             buildConfigField "boolean", "SERVER_DEBUG", 'false'
  33.             dimension "jianghu_browser"
  34.             signingConfig signingConfigs.browser    //签名，在以上signingConfigs中配置
  35.         }
  36.         duoxing {
  37.             applicationId "org.fsll.duoxing5"
  38.             resValue "string", "app_name", "多星5"
  39.             resValue "string", "icon", "@mipmap/dx5_launcher"
  40.             resValue "string", "service_name", "duoxing_service"
  41.             resValue "string", "screen", "@drawable/screen"
  42.             resValue "color", "primary", "#FF00579c"
  43.             buildConfigField "boolean", "SERVER_DEBUG", 'false'
  44.             dimension "jianghu_browser"
  45.             signingConfig signingConfigs.duoxing
  46.         }
  47.         jianghu3 {
  48.             applicationId "org.fsll.jianghu3"
  49.             resValue "string", "app_name", "江湖3"
  50.             resValue "string", "icon", "@mipmap/jianghu_launcher"
  51.             resValue "string", "service_name", "jianghu_service"
  52.             resValue "string", "screen", "@drawable/screen"
  53.             resValue "color", "primary", "#FFff5300"
  54.             buildConfigField "boolean", "SERVER_DEBUG", 'false'
  55.             dimension "jianghu_browser"
  56.             signingConfig signingConfigs.jianghu3
  57.         }
  58.     }
  59. }

签名的相关说明可以参考 生成签名。

IOS的多应用配置

图标的配置

  • 图标的生成

可以访问 图标工厂，上传jpg/png/psd文件，即可同时生成 iOS、Android 和 PhoneGap
 应用的图标。遵循 Apple、 Google 官方标准。支持自定义大小、自动圆角、角标和徽章等。支持 Web App, iWatch 等更多平台。快速预览将要在不同设备上显示的应用图标，无需部署即可通过预览来调整设计样式。

  • 图标的使用

  • target的配置

  1. Duplicate target的项目，名字不要空格

  2. 新建Assets.xcassets，重命名，放入新图标，右键 new Color set 设置专用颜色

  3. 新建LaunchScreen.storyboard，重命名，view设置不同颜色

  4. 选择taget目标， General中设置ID，图标，启动图

  5. 在AppDelegate.swift中，根据对应的app ID，配置对应的背景颜色

  6. 在Ios->Runner->AppDelegate.swift->application中添加代码

    1.  override func application(
    2.      _ application: UIApplication,
    3.      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    4.  ) -> Bool {
    5.      ...
    6.      setAppBackgroundColor(forBundleIdentifier: "org.fsll.duoxing5", withColorName: "duoxingColor")
    7.      ...
    8.  }
    9.  
    10.  func setAppBackgroundColor(forBundleIdentifier bundleIdentifier: String, withColorName colorName: String) {
    11.      if Bundle.main.bundleIdentifier == bundleIdentifier, let color = UIColor(named: colorName) {
    12.          window?.backgroundColor = color
    13.      }
    14. }

  7. 切换到Build settings，搜索info.plist，地址更换为新生成的新的 Info.plist

  8. 选择Target目标，点击左下角+, 添加 Share-Extension，配置Share-Extension的info.plist，配置ShareViewController的代码

  9. 在General的Framework、Libraries、and Embedded content，点击+，选择专属的Share-Extension，

  10. 配置专属的scheme，一般会自动生成，没有就手动新加个，相关选项，选择对应的新的target就行

  11. 选择新的scheme，选择设备启动

  12. 在product的archive，生成新的包发到app store就可以了

  13. 要在flutter中能正常使用flover启动，还需如下配置

  14. 在podfile中，配置target 新 target NewTargetName do名字，直接复制原来的target Runner do就可以，几个target，就复制几次，每个target名字都配置上，project Runner不要动

  15. 命令行导航到项目的iOS目录，先后运行：rm -rf Pods Podfile.lock，pod deintegrate，pod install

  16. 在iOS/Flutter目录中复制Debug.xcconfig, release同样，修改名字为(Debug | Relase)-NewTargetName.xcconfig，修改其内容的Pods-Runner -> Pods-NewTargetName

  17. 在Xcode中，选择 project runner -> info，选择configurations，复制(Debug、Release)为新的(Debug | Release)-NewTargetName，

  18. 展开新的配置(Debug | Release)-NewTargetName，选择对应的NewTargetName，选择他的Based On Config File为对应的xcconfig，只需要修改自身对应的Target即可，其他的不用管，默认即可

  19. 在Xcode，选择修改scheme，修改相关的config的地方为新的config配置

  20. 在Android Studio，项目中的Edit Configuration中，启动参数添加--flavor=NewTargetName

  21. 成功后，flutter端启动app即可

多包分配后可能出现的Bug

  • xcode rsync error: some files could not be transferred (code 23) at main.c
  • XCode14.X, 编译(build)正常，打包(Archive)出错
  2. PhaseScriptExecution [CP]\ Embed\ Pods\ Frameworks /Users/zhangzheng/Library/Developer/Xcode/DerivedData/OWON-abukyxpajbueubdempshornbemjw/Build/Intermediates.noindex/ArchiveIntermediates/OWON/IntermediateBuildFilesPath/OWON.build/Release-iphoneos/OWON.build/Script-361D99D13FFD29F042D080E7.sh (in target 'OWON' from project 'OWON')
  4. sent 29 bytes  received 20 bytes  98.00 bytes/sec
  5. total size is 0  speedup is 0.00
  6. rsync error: some files could not be transferred (code 23) at /AppleInternal/Library/BuildRoots/97f6331a-ba75-11ed-a4bc-863efbbaf80d/Library/Caches/com.apple.xbs/Sources/rsync/rsync/main.c(996) [sender=2.6.9]
  8. Command PhaseScriptExecution failed with a nonzero exit code

解决办法

  1. 在Pods/Targets Support Files/Pods-NewTargetName/Pods-NewTargetName-frameworks.sh中找到代码 source="$(readlink "${source}")"
  2. 替换成source="$(readlink -f "${source}")", // 注意-f后边有个空格
  3. 重新Archive打包，就成功了

模拟器上就是不出现在系统分享列表里

  • 在主程序target -> Build Phases -> Embed Foundation Extensions下，取消勾选Copy only when installing