stutya/ionic

stutya/ionic镜像说明

镜像概述

本镜像旨在为Ionic 1至5版本的Cordova或Capacitor应用提供Android APK构建环境，支持集成Gitlab CI实现自动化构建流程，帮助开发者高效生成应用安装包。

核心功能

• 支持Ionic 1/2/3/4版本的Cordova应用APK构建
• 支持Ionic 4/5版本的Capacitor应用APK构建
• 提供Gitlab CI配置示例，实现自动化构建
• 缓存依赖包（node_modules）以提升构建效率

使用场景

• Gitlab代码仓库中Ionic应用的自动化Android APK构建
• 不同版本Ionic项目的统一构建环境管理
• 持续集成/持续部署（CI/CD）流程中的APK生成环节

配置说明

1. Ionic 1/2/3/4 Cordova应用的Gitlab CI配置

创建.gitlab-ci.yml文件，内容如下：

yaml
image: docker.xuanyuan.run/stutya/ionic:latest

stages:
  - deploy

cache:
  untracked: true
  key: "$CI_PROJECT_ID"
  paths:
    - node_modules/

build_android:
  stage: deploy
  only:
    - master
    # - <another-branch> // 填写需要构建的分支
  script:
    - npm i
    - ionic cordova platform rm android
    - ionic cordova platform add android
    - ionic cordova build android
    - cp platforms/android/app/build/outputs/apk/*/*.apk ../app.apk
  artifacts:
    paths:
      - app.apk

配置完成后，Gitlab CI会自动构建APK并生成可下载的 artifacts。

2. Ionic 4/5 Capacitor应用的Gitlab CI配置

创建.gitlab-ci.yml文件，内容如下：

yaml
image: docker.xuanyuan.run/stutya/ionic:latest

stages:
  - deploy
  
cache:
  untracked: true
  key: "$CI_PROJECT_ID"
  paths:
    - node_modules/
    
build_android:
  stage: deploy
  only:
    - master
    - ci-test
  script:
    - npm i
    - npm run build
    - npx cap sync android
    - cd android/ && ./gradlew assembleRelease
    - cp ./app/build/outputs/apk/*/*.apk ../app.apk
  artifacts:
    paths:
      - app.apk

配置完成后，Gitlab CI会自动构建APK并生成可下载的 artifacts。