# ShellExample

**Repository Path**: zonda89/shell_example

## Basic Information

- **Project Name**: ShellExample
- **Description**: shell_脚本示例
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-20
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# flutter_build_apk_script

### 📦 项目介绍
存放脚本

### 必须安装
- `wget` 工具
- `jq` JSON 处理器

### Windows 安装
```powershell
choco install wget  # 文件下载工具
choco install jq    # JSON 处理工具
```

### 使用说明
大家注意下，如果大家开发的项目flutter版本不是 3.19.0 是 3.24.2 ，必须在项目工程根目录加上文件  **specified_version.txt**  里面写 3.24.2

> 对于旧项目后端做了兼容处理，后端jekins逻辑:
> 如果项目里面没有 specified_version.txt 文件，
> 就读一下原有项目的 build.sh 文件 
> 如果有下面这个字符串 /home/flutter/flutter3242 ,默认脚本就用 3.24.2，反之就用 3.19.0

2025/05/14

- 新增仓库校验逻辑，即之前需要手动添加的两个仓库由脚本自动添加

- 新增读取配置json文件逻辑，后端只要jekins实现：在 remote_build.sh 脚本的同级目录下，新建一个文件  **remote_configs.json**  ，然后，把原始autoPackageJson内容复制到该文件中即可走 json 打包逻辑，可自动更换应用 Icon。

- 注意要想项目支持自动更换应用 Icon 必须严格遵循一下规定：

    1. android 原生侧图片必须放在 ./android/app/src/main/res/mipmap-xhdpi/ 
    2. Flutter 侧图片必须放在 .assets/images/mine/ 目录下面
    3. android 原生侧图片命名必须为ic_launcher_myapp 
    4. Flutter 原生侧图片命名必须为icon_app
    5. 短剧 Flutter 侧图片沿用就有逻辑，放在 ./packages/pkg_panda/assets/drawable/ 目录，命名为 icon_splash_logo

  **！！！注意：在上面提到的目录中，除了应用图标外的图片，禁止定义为 ic_launcher icon_app icon_splash_logo，哪怕以它们任意一个开头也不行**  

- 接入自动打包的icon，要点：
    1. 之前有icon和封面图一起的情况需要手动适配
    2. 看打包自动脚本的json能否提供一张封面图？resPath用来干嘛的，可以用来传封面吗？
    3. 老项目如果启用新脚本，还是需要产品自行验证应用Icon和启动封面是否正确，由于之前没有硬性规定，不一定能兼容所有老项目
    4. 图片格式必须要是 png 的 (如果不是的话，会报错：   AAPT: error: file failed to compile. )。

#### optimum_remote_build 暂时搁置
初衷：自动集成广告参数、配置文件；把 3.19.0 和 3.24.2 合并;
改动较大，考虑后面先用本地脚本实现后再切到远程脚本
#### 参与贡献
见提交日志

sh keystore_params_build.sh xxxx,xxxx