# FlutterWidgetCore

**Repository Path**: HZKQ/flutter-widget-core

## Basic Information

- **Project Name**: FlutterWidgetCore
- **Description**: 科强Flutter组件库Core公用核心库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 3
- **Created**: 2023-09-25
- **Last Updated**: 2025-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# kq_flutter_core_widget
科强Flutter核心库

## 其它变体的管理
![](branch_desc.png)

## Getting Started

- ### android
  由于原生依赖com.keqiang.modules:base库，base库依赖com.gitee.zhouzhuo0810:MagpieX，
  因此需要做以下初始化：
  ```kotlin
    class MainApp : Application() {
      override fun onCreate() {
          super.onCreate()
          // MagpieX基础工具初始化
          BaseUtil.init(this)
          // MagpieX原生屏幕适配初始化
          ScreenAdapterUtil.init(this)
          // base库初始化
          // 第二个参数表示是否是debug模式，此值决定base库中日志是否打印及一些只在debug模式操作的逻辑
          // 第三个参数用于文件选择，图片选择等获取图片的路径，适配高版本的文件路径获取逻辑
          // 第四个参数用于指定默认缓存数据的根目录。用于如拍照存储图片等
          initApplication(this,
              debugMode,
              fileProviderAuthorities,
              cacheDirPath)
      }
    
      override fun onConfigurationChanged(newConfig: Configuration) {
          super.onConfigurationChanged(newConfig)
          // 配置变了，需要重置屏幕缩放
          SimpleUtil.resetScale(this)
      }
    }
  ```
  ```xml
   <!--MagpieX屏幕适配，还需要在项目AndroidManifest.xml中配置以下数据-->
   <manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>
        <!--设计图的宽,按照竖屏设备宽配置，即使运行设备是横屏设备。单位是像素,推荐用markman测量-->
        <meta-data
            android:name="design_width"
            android:value="1080" />
        <!--设计图的高,,按照竖屏设备高配置，即使运行设备是横屏设备。单位是像素,推荐用markman测量-->
        <meta-data
            android:name="design_height"
            android:value="1920" />
        <!--屏幕适配类型-->
        <meta-data
            android:name="screen_adapt_type"
            android:value="width" />

        <!--设计图对应的标准dpi,根据下面的那张图找到对应的dpi,比如1080就对应480dpi,如果拿到的是其他宽度的设计图,那么选择一个相近的dpi就好了-->
        <!--
            宽         	    240 	320 	480 	720     1080 	1440
            DPI等级	    LDPI	MDPI	HDPI	XHDPI	XXHDPI	XXXHDPI
            DPI数值	    120	        160	240	320	480	640
        -->
        <meta-data
            android:name="design_dpi"
            android:value="480" />

        <!--全局字体的大小倍数,有时候老板会觉得你的所有的字小了或者大了,你总不能一个一个去改吧-->
        <meta-data
            android:name="font_size"
            android:value="1.0" />

        <!--你的布局里面用的是px这就写px,你的布局里面用的是dp这就写dp,要统一,不要一会儿px一会儿dp,字体也用px或者dp,不要用sp,微信qq用的肯定不是sp.-->
        <meta-data
            android:name="unit"
            android:value="px" />
    </application>
  </manifest>
  ```

- ### ios
暂无特殊说明

- ### ohos
暂无特殊说明

## 使用QQ授权登录/分享
目前支持IOS,Android,OHOS平台。以下未注明的平台则不用加任何配置，直接使用。

- 运行在Android平台则需要在项目pubspec.yaml中添加以下配置：
```yaml
# kq_flutter_core_widget与dependencies同级
kq_flutter_core_widget:
  qq_app_id: 申请的appId
```

- 运行在IOS平台则需要在项目pubspec.yaml中添加以下配置：
```yaml
# kq_flutter_core_widget与dependencies同级
kq_flutter_core_widget:
  ios_qq_app_id: iOS申请的QQ appId
  ios_app_link: iOS申请的universal_link
  ios_project_name: 原生项目名称
  ios_project_path: 原生项目相对路径
```

- 运行在OHOS平台则需要在原生项目entry module.json5添加以下配置：
```json5
{
  "module": {
    // 添加querySchemes，用于查询QQ是否安装
    "querySchemes": [
      "https",
      "qqopenapi"
    ],
    "abilities": [
      {
        "name": "EntryAbility",
        // 添加skills以下内容，此Ability需要为Flutter的启动Ability
        "skills": [
          {
            "entities": [
              "entity.system.browser"
            ],
            "actions": [
              "ohos.want.action.viewData"
            ],
            "uris": [
              {
                "scheme": "qqopenapi",
                "host": "申请的 appId",
                "path": "auth",
                "linkFeature": "Login",
              }
            ]
          }
        ]
      }
    ]
  }
}
```

## 使用微信授权登录/分享
目前支持IOS,Android,OHOS平台。以下未注明的平台则不用加任何配置，直接使用。

- 运行在IOS平台则需要在项目pubspec.yaml中添加以下配置：
```yaml
# kq_flutter_core_widget与dependencies同级
kq_flutter_core_widget:
  ios_wx_app_id: iOS申请的微信appId
  ios_app_link: iOS申请的universal_link
  ios_project_name: 原生项目名称
  ios_project_path: 原生项目相对路径
```

## 使用钉钉授权登录/分享
目前支持IOS,Android,OHOS平台，仅android平台支持登录。以下未注明的平台则不用加任何配置，直接使用。

- 运行在IOS平台则需要在项目pubspec.yaml中添加以下配置：
```yaml
# kq_flutter_core_widget与dependencies同级
kq_flutter_core_widget:
  ios_dd_app_id: iOS申请的钉钉appId
  ios_app_link: iOS申请的universal_link
  ios_project_name: 原生项目名称
  ios_project_path: 原生项目相对路径
```