Walle 项目安装和配置指南

Walle 项目安装和配置指南

walle Meituan-Dianping/walle: Walle 是美团点评开源的一款 Android 打包工具，提供了一站式的 App 发布解决方案，包括但不限于多渠道打包、自动签名、自动上传到分发平台等功能。 项目地址: https://gitcode.com/gh_mirrors/wa/walle

1. 项目基础介绍和主要编程语言

Walle（瓦力）是一个由美团点评开源的 Android 渠道包打包工具。它通过在 APK 的 APK Signature Block 区块中添加自定义的渠道信息，从而提高了渠道包的生成效率。Walle 可以作为单机工具使用，也可以部署在 HTTP 服务器上，实时处理渠道包 APK 的升级网络请求。

该项目主要使用 Java 和 Groovy 编程语言。

2. 项目使用的关键技术和框架

Walle 项目主要使用了以下关键技术和框架：

• Android Signature V2 Scheme：用于在 APK 签名块中添加自定义渠道信息。
• Gradle：作为构建工具，支持 Gradle 插件方式集成。
• Apache Maven：支持 Maven 方式集成。

3. 项目安装和配置的准备工作和详细安装步骤

3.1 准备工作

在开始安装和配置 Walle 之前，请确保你已经安装了以下软件和工具：

• Java Development Kit (JDK)：建议使用 JDK 8 或更高版本。
• Android Studio：用于 Android 开发。
• Gradle：建议使用 Gradle 5.0 或更高版本。

3.2 安装步骤

3.2.1 克隆项目仓库

首先，从 GitHub 上克隆 Walle 项目到本地：

git clone https://github.com/Meituan-Dianping/walle.git

3.2.2 配置 Gradle 插件

1. 在项目的根目录 build.gradle 文件中添加 Walle Gradle 插件的依赖：

   buildscript {
       dependencies {
           classpath 'com.meituan.android.walle:plugin:1.1.7'
       }
   }
   

2. 在当前 App 的 build.gradle 文件中应用这个插件，并添加上用于读取渠道号的 AAR：

   apply plugin: 'walle'
   
   dependencies {
       implementation 'com.meituan.android.walle:library:1.1.7'
   }
   

3. 配置插件：

   在 build.gradle 文件中添加以下配置：

   walle {
       // 指定渠道包的输出路径
       apkOutputFolder = new File("${project.buildDir}/outputs/channels")
   
       // 定制渠道包的 APK 的文件名称
       apkFileNameFormat = '${appName}-${packageName}-${channel}-${buildType}-v${versionName}-${versionCode}-${buildTime}.apk'
   
       // 渠道配置文件
       channelFile = new File("${project.getProjectDir()}/channel")
   }
   

3.2.3 创建渠道配置文件

在项目的根目录下创建一个名为 channel 的文件，内容如下：

# 渠道配置文件示例
meituan
dianping

3.2.4 生成渠道包

使用以下命令生成渠道包：

./gradlew clean assembleReleaseChannels

3.3 验证安装

生成渠道包后，可以在指定的输出路径（如 ${project.buildDir}/outputs/channels）中找到生成的 APK 文件。每个 APK 文件名中将包含对应的渠道信息。

4. 总结

通过以上步骤，你已经成功安装并配置了 Walle 项目，并生成了带有渠道信息的 APK 文件。Walle 的使用可以大大提高 Android 渠道包的打包效率，适用于各种自定义需求。

walle Meituan-Dianping/walle: Walle 是美团点评开源的一款 Android 打包工具，提供了一站式的 App 发布解决方案，包括但不限于多渠道打包、自动签名、自动上传到分发平台等功能。 项目地址: https://gitcode.com/gh_mirrors/wa/walle