https://github.com/hpoul/git-buildnumber

Create a continuous, consistent buildnumber independent of branch.
https://github.com/hpoul/git-buildnumber

buildnumber ci continuous-integration flutter git git-buildnumber

Last synced: 5 days ago
JSON representation

Create a continuous, consistent buildnumber independent of branch.

• Host: GitHub
• URL: https://github.com/hpoul/git-buildnumber
• Owner: hpoul
• Created: 2019-02-28T23:05:10.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-02-06T21:59:02.000Z (11 months ago)
• Last Synced: 2024-12-03T03:35:33.743Z (22 days ago)
• Topics: buildnumber, ci, continuous-integration, flutter, git, git-buildnumber
• Language: Shell
• Size: 31.3 KB
• Stars: 3
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# git-buildnumber.sh

Create a continuous, consistent buildnumber independent of branch.

Synchronizes with the remote `origin` repository.

This is especially useful to create unique build numbers for mobile apps which are distributed in app stores, but might be built across different build servers. So you can easily use the build number as `versionCode` on android or `CFBundleVersion` on iOS. If you have a cross platform app in one repository, this makes sure that when building each version of the app (even on different build servers) they will have the same build number (if built from the same commit).

Behavior: first it checks if the current git commit has a build number already assigned to it, if so this one will be used, otherwise the global build number of the repository is incremented. (this guarantees that all builds from one and the same commit, even across built variants and platforms have the same build number).

Manages build numbers based on `refs/buildnumbers/last` and notes in `refs/notes/buildnumbers`.

# Install

## Homebrew

```bash

brew tap hpoul/tap

brew install git-buildnumber

```

## By hand

```bash

curl -O https://raw.githubusercontent.com/hpoul/git-buildnumber/v1/git-buildnumber.sh

chmod +x git-buildnumber.sh

sudo mv git-buildnumber.sh /usr/local/bin/

```

If you just want to use it on a CI you could obviously also just run it directly to generate a new build number:

`curl -s https://raw.githubusercontent.com/hpoul/git-buildnumber/master/git-buildnumber.sh | bash /dev/stdin generate`

feel free to pin a specific version or hash 😉️

`curl -s https://raw.githubusercontent.com/hpoul/git-buildnumber/v1/git-buildnumber.sh | bash /dev/stdin generate`

# Usage

Run inside your git repository. It expects the master remote repository to be named `origin` right now.

```bash

# Generates a new build number for the current commit, 

# or outputs the build number for the current commit, if it exists:

./git-buildnumber.sh generate

```

```bash

sh>>> ./git-buildnumber.sh help

git-buildnumber, version 1.0

Usage: ./git-buildnumber.sh 

Commands:

  generate             -- The default, outputs build number for current commit

                          or generates a new one.

  find-commit  -- Finds the commit (message) for a given build number.

  force        -- Uses the given number as the current buildnumber of

                          the current commit.

  get                  -- show the build number for the current commit (if any)

  sync                 -- fetch && push

  fetch                -- fetch all refs from remote

  push                 -- push all refs from remote

```