华为应用市场发布Gradle插件使用手册

华为应用市场发布Gradle插件使用手册

huawei-appgallery-publish-gradle-pluginHuawei AppGallery Publish Gradle Plugin allows you to publish the android release build file (*.apk or *.aab) to the Huawei AppGallery store项目地址:https://gitcode.com/gh_mirrors/hu/huawei-appgallery-publish-gradle-plugin

1. 项目目录结构及介绍

该开源项目基于GitHub，地址是 huawei-appgallery-publish-gradle-plugin，主要用于简化Android应用发布到华为AppGallery的过程。以下是典型的项目结构概览：

.
├── README.md           # 主要的说明文件，包含了项目简介和快速指南。
├── src                 # 源码目录，通常包含插件的核心代码实现。
│   ├── main            # 插件的主要源代码和资源。
│   │   ├── groovy      # Groovy脚本，用于定义Gradle插件逻辑。
│   │   └── resources   # 可能包含的资源配置文件。
├── build.gradle        # 插件本身的构建配置文件。
└── ...                 # 其他常规Git或Gradle项目管理文件。

重要文件介绍:

• README.md: 提供了详细的安装、配置和使用步骤，是开发者首次接触时的重要参考。
• src/main/groovy: 包含了插件的核心类，负责实现将APK或AAB文件上传至华为AppGallery的功能。

2. 项目的启动文件介绍

项目没有特定的“启动文件”以传统应用程序的形式存在。在Gradle插件中，关键的启动逻辑通常是通过扩展Gradle的任务来实现的。这意味着，当您在自己的Android项目中应用此插件后，通过执行如assembleRelease followed by publishHuaweiAppGalleryRelease这样的Gradle命令来“启动”发布流程。这些任务是在插件的Groovy脚本内定义并注册的。

3. 项目的配置文件介绍

Gradle插件配置

配置主要发生在您自己的Android项目的build.gradle（app模块）或使用Kotlin DSL的build.gradle.kts文件中。通过引入这个插件并根据需求进行配置，可以控制发布行为。基本配置示例如下：

// build.gradle 或 build.gradle.kts 示例片段
plugins {
    id 'com.example.huawei.publish' version 'X.Y.Z' // 替换为实际版本号
}

huaweiPublish {
    instances {
        create("release") {} // 创建一个名为'release'的发布实例
        create("demoRelease") { /* 配置参数 */ }
    }
}

CLI配置与覆盖

此外，插件允许通过CLI（命令行界面）参数动态覆盖配置，这提供了灵活性，让您能在构建过程中调整设置，比如通过以下命令：

./gradlew assembleRelease publishHuaweiAppGalleryRelease \
    --deployType=draft \
    --credentialsPath="/path/to/credentials.json"

在这个场景中，--deployType 和 --credentialsPath 就是用来覆盖默认配置的。

---

通过遵循上述指南，您可以有效地集成并配置这个插件，进而简便地管理和自动化您的华为应用市场发布流程。

huawei-appgallery-publish-gradle-pluginHuawei AppGallery Publish Gradle Plugin allows you to publish the android release build file (*.apk or *.aab) to the Huawei AppGallery store项目地址:https://gitcode.com/gh_mirrors/hu/huawei-appgallery-publish-gradle-plugin