Flutter插件dart_jvcl的安装与使用

在Flutter开发中，有时候我们需要将一些自动化工具集成到项目中，以简化构建和发布流程。本文将介绍如何使用dart_jvcl插件来实现Jenkins自动获取日志的功能。

Flutter插件dart_jvcl的安装

首先，你需要安装dart_jvcl插件。可以通过以下命令进行安装：

dart pub global activate dart_jvcl

Flutter插件dart_jvcl使用之前

在使用dart_jvcl之前，你需要配置一些参数供脚本使用。这些参数可以来源于Jenkins的参数构建，也可以通过脚本自定义设置。

配置参数

• BRANCH: 打包的分支（这个可以来源于Git Parameter这个插件）
• MODE: 打包的模式，目前支持profile和release。
  • profile模式支持自动从Git获取日志。
  • release模式只支持设置的日志。
• BUILD_NAME: 版本号。
• LAST_BUILD_COMMIT: 上一次打包的Git commit hash值，可以不设置。
• GIT_LOG: 自定义日志。
• JENKINS_USERNAME: Jenkins的用户名。
• JENKINS_PASSWORD: Jenkins的密码。

示例代码

以下是一个完整的示例代码，展示了如何使用dart_jvcl插件来实现Jenkins自动获取日志的功能。

import 'package:dart_jvcl/dart_jvcl.dart';

void main() async {
  // 配置参数
  final branch = 'main'; // 打包的分支
  final mode = 'profile'; // 打包模式
  final buildName = '1.0.0'; // 版本号
  final lastBuildCommit = ''; // 上一次打包的commit hash，可选
  final gitLog = 'Initial commit'; // 自定义日志
  final jenkinsUsername = 'your_username'; // Jenkins用户名
  final jenkinsPassword = 'your_password'; // Jenkins密码

  // 初始化插件
  final jvcl = JVCL(
    branch: branch,
    mode: mode,
    buildName: buildName,
    lastBuildCommit: lastBuildCommit,
    gitLog: gitLog,
    jenkinsUsername: jenkinsUsername,
    jenkinsPassword: jenkinsPassword,
  );

  // 执行Jenkins任务
  await jvcl.executeJenkinsJob();

  print('Jenkins任务执行完成');
}

代码说明

1. 导入插件:

   import 'package:dart_jvcl/dart_jvcl.dart';
   

   导入dart_jvcl插件以便使用其功能。

2. 配置参数:

   final branch = 'main'; // 打包的分支
   final mode = 'profile'; // 打包模式
   final buildName = '1.0.0'; // 版本号
   final lastBuildCommit = ''; // 上一次打包的commit hash，可选
   final gitLog = 'Initial commit'; // 自定义日志
   final jenkinsUsername = 'your_username'; // Jenkins用户名
   final jenkinsPassword = 'your_password'; // Jenkins密码
   

   设置必要的参数用于Jenkins任务。

3. 初始化插件:

   final jvcl = JVCL(
     branch: branch,
     mode: mode,
     buildName: buildName,
     lastBuildCommit: lastBuildCommit,
     gitLog: gitLog,
     jenkinsUsername: jenkinsUsername,
     jenkinsPassword: jenkinsPassword,
   );
   

   使用配置的参数初始化JVCL对象。

4. 执行Jenkins任务:

   await jvcl.executeJenkinsJob();
   

   调用executeJenkinsJob方法来执行Jenkins任务。

5. 打印结果:

   print('Jenkins任务执行完成');