Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gabrielrobert/xavtool

Xplat Automating Version Tool
https://github.com/gabrielrobert/xavtool

android cli ios semver uwp xamarin

Last synced: 3 months ago
JSON representation

Xplat Automating Version Tool

Host: GitHub
URL: https://github.com/gabrielrobert/xavtool
Owner: gabrielrobert
License: mit
Created: 2018-02-24T15:11:55.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2018-12-19T21:38:41.000Z (almost 6 years ago)
Last Synced: 2024-06-20T15:56:09.377Z (5 months ago)
Topics: android, cli, ios, semver, uwp, xamarin
Language: Go
Homepage: https://gabrielrobert.github.io/xavtool/
Size: 1.58 MB
Stars: 35
Watchers: 4
Forks: 2
Open Issues: 9
Metadata Files:
- Readme: readme.md
- License: LICENSE

Awesome Lists containing this project

awesome-ios - xavtool - Command-line utility to automatically increase iOS / Android applications version. (Tools / Web View)
awesome-cordova - xavtool
awesome-xamarin - Xavtool ★15 - Command-line utility to automatically increase iOS / Android / UWP applications version. (Tools)
awesome-ios-star - xavtool - Command-line utility to automatically increase iOS / Android applications version. (Tools / Web View)

README

        ![Header](https://i.imgur.com/ndlN2v3.png "Header")

# Xplat Automating Version Tool

[![Build status](https://ci.appveyor.com/api/projects/status/6lfimg1j4pw9f807?svg=true)](https://ci.appveyor.com/project/grobert092/xavtool)

[![Build Status](https://travis-ci.org/gabrielrobert/xavtool.svg?branch=master)](https://travis-ci.org/gabrielrobert/xavtool)

Command-line utility to automatically increase iOS / Android / UWP applications version written in [Go](https://golang.org/). It follows [Semantic Versioning](https://semver.org/).

## Installation

### Windows:

Using [Chocolatey](https://chocolatey.org/):

```bash

$ choco install xavtool -version 1.2.1

$ xavtool --version

```

Using [scoop](http://scoop.sh/):

```bash

$ scoop bucket add gabrielrobert-bucket https://github.com/gabrielrobert/scoop-bucket

$ scoop install xavtool

```

### macOS:

Using [brew](https://brew.sh/):

```bash

$ brew install gabrielrobert/tap/xavtool

$ xavtool --version

```

### Binaries

Download executables on the [release page](https://github.com/gabrielrobert/xavtool/releases/latest).

### From source:

```bash

$ go build

$ go test -v

$ go install

$ xavtool --version

```

## Usage

```bash

$ xavtool

NAME:

   xavtool - Command-line utility to automatically increase applications version

USAGE:

   xavtool [global options] command [command options] [arguments...]

VERSION:

   1.2.1

AUTHOR:

   Gabriel Robert 

COMMANDS:

     current, c    List current versions

     increment, i  Increment to next version

     set, s        Set the current project version

     help, h       Shows a list of commands or help for one command

GLOBAL OPTIONS:

   --help, -h     show help

   --version, -v  print the version

```

### increment

```bash

$ xavtool increment --help

NAME:

   xavtool increment - Increment to next version

USAGE:

   xavtool increment [command options] [arguments...]

OPTIONS:

   --type value, -t value  major, minor, patch (default: "minor")

```

### set

```bash

$ xavtool set --help

NAME:

   xavtool set - Set the current project version

USAGE:

   xavtool set [arguments...]

```

## Typical flow

```bash

$ xavtool current

1.0.1 - androidApp (...\test\AndroidManifest.xml)

1.0.1 - iOSApp (...\test\Info.plist)

1.0.1.0 - uwpApp (...\test\Package.appxmanifest)

$ git flow release start '1.1.0'

$ xavtool i

1.0.1: New version: 1.1.0 (...\test\AndroidManifest.xml)

1.0.1: New version: 1.1.0 (...\test\Info.plist)

1.0.1.0: New version: 1.1.0.0 (...\test\Package.appxmanifest)

$ git commit -am "Version bump to 1.1.0"

$ git flow release finish -p

```

It will update these files:

- `Info.plist`

- `AndroidManifest.xml`

- `Package.appxmanifest`

## Results

### Info.plist (iOS)

Only these values will be edited:

1) `CFBundleShortVersionString` (new version)

2) `CFBundleVersion` (new version)

Before:

```plist

    

        

        CFBundleShortVersionString

        1.0.1

        CFBundleVersion

        1.0.1

        

    

```

After:

```plist

    

        

        CFBundleShortVersionString

        1.1.0

        CFBundleVersion

        1.1.0

        

    

```

### AndroidManifest.xml (Android)

Only these values will be edited:

1) `manifest/@android:versionName` (new version)

2) `manifest/@android:versionCode` (integer computed this way: `(major * 1000000) + (minor * 10000) + (patch * 100)`)        

Before:

```xml

    

```

After:

```xml

    

```

### Package.appxmanifest (UWP)

Only these values will be edited:

1) `Package/Identity/@Version` (new version with a revision number set to 0)

Before:

```xml

    

    

    

    

    

```

After:

```xml

    

    

    

    

    

```

### config.xml (Cordova)

Only these values will be edited:

1) `widget/@version` (new version)

2) `widget/@ios-CFBundleVersion` (new version)

3) `widget/@android-versionCode` (integer computed this way: `(major * 1000000) + (minor * 10000) + (patch * 100)`)        

Before:

```xml

  

```

After:

```xml

  

```

## Support

Please [open an issue](https://github.com/gabrielrobert/xavtool/issues/new) for support.

## Contributing

Please contribute using [Github Flow](https://guides.github.com/introduction/flow/). Create a branch, add commits, and [open a pull request](https://github.com/gabrielrobert/xavtool/compare).