Makefile

SHELL:=/bin/bash

ifndef VERBOSE
.SILENT:
endif

export ROOT=$(shell pwd)
export CONFIG=setup
export PACKAGES=packages

ifeq ($(DEVICE),)
	export DEVICE=RPi
endif

ifeq ($(OUTPUT),)
	export OUTPUT_DIR=$(ROOT)/../Clue-out
else
	export OUTPUT_DIR=$(OUTPUT)
endif

ifeq ($(PUBLISH),)
	export PUBLISH=~/AMSD/Web/clue/repos/releases
endif

# Global variables
DISTRO_GITHTAG=$(shell git describe --abbrev=0 --tags 2>/dev/null)
DISTRO_NAME=$(shell cat /tmp/.cluevars 2>/dev/null | grep -i "distroname" | cut -f2 -d"=")
DISTRO_VERSION=$(shell cat /tmp/.cluevars 2>/dev/null | grep -i "distroversion" | cut -f2 -d"=")
IMAGE_NAME=$(shell cat /tmp/.cluevars 2>/dev/null | grep -i "imagename" | cut -f2 -d"=")
TARGETS=$(shell cat /tmp/.cluevars 2>/dev/null | grep -i "localtargets" | cut -f2 -d"=")


# Display release information
info:
ifeq ($(wait),on)
	./$(CONFIG)/build "info" wait
else
	./$(CONFIG)/build "info"
endif


# Setup build counter in order to describe the next release version
next:
	./$(CONFIG)/build "next"
	$(eval DISTRO_VERSION=`cat /tmp/.cluevars 2>/dev/null | grep -i "distroversion" | cut -f2 -d"="`)
	echo "New release build: $(DISTRO_VERSION)"


# Build particular package or the entire system
#	@package - package name with optional target [:<host|target|init|bootstrap>]
#	@parent parent of the specified package
#	- in case no one of these parameters is specified then the process build is called
build:
ifneq ($(package),)
	./$(CONFIG)/build $(package) $(parent) | tee $(OUTPUT_DIR)/build.log
else
ifneq ($(packages),)
	rm -rf $(OUTPUT_DIR)/build.log
	for pack in $(packages) ; do ./$(CONFIG)/build $$pack | tee -a $(OUTPUT_DIR)/build.log ; done
else
ifneq ($(local),on)
	$(MAKE) next
endif
	$(MAKE) info -e wait=on
	./$(CONFIG)/build | tee $(OUTPUT_DIR)/build.log
endif
endif


# Build Clue OS release image
image:
ifneq ($(local),on)
	$(MAKE) next
endif
	$(MAKE) info -e wait=on
ifneq ($(TARGETS),)
	rm -rf $(TARGETS)/$(DISTRO_NAME)-$(DISTRO_VERSION)*
endif
	./$(CONFIG)/build "image" | tee $(OUTPUT_DIR)/build.log


# Install (and build in case was not yet built) a particular package
#	@package - package name with optional target [:<host|target|init|bootstrap>]
#	@parent parent of the specified package
install:
ifneq ($(package),)
	./$(CONFIG)/install $(package) $(parent) | tee $(OUTPUT_DIR)/install.log
else
ifneq ($(packages),)
	rm -rf $(OUTPUT_DIR)/install.log
	for pack in $(packages) ; do ./$(CONFIG)/install $$pack | tee -a $(OUTPUT_DIR)/install.log ; done
else
	$(error Please specify 'package' parameter, and optional 'parent' parameter!)
endif
endif

# Clean-up package resources like source code and all build pack (in case @package
# parameter is specified) or clean-up the entire build distribution (including stamps)
#	@package - package name with optional target [:<host|target|init|bootstrap>]
clean:
ifneq ($(package),)
ifneq ($(parent),)
	./$(CONFIG)/clean $(package) $(parent) | tee $(OUTPUT_DIR)/clean.log
else
	./$(CONFIG)/clean $(package) | tee $(OUTPUT_DIR)/clean.log
endif
else
ifneq ($(packages),)
	rm -rf $(OUTPUT_DIR)/clean.log
	for pack in $(packages) ; do ./$(CONFIG)/clean $$pack | tee -a $(OUTPUT_DIR)/clean.log ; done
else
	rm -rf $(OUTPUT_DIR)/*-${DEVICE}.* $(OUTPUT_DIR)/.stamps
endif
endif


# Clean-up all build distributions, cache and stamps
cleanall:
	rm -rf $(OUTPUT_DIR)/* $(OUTPUT_DIR)/.stamp $(OUTPUT_DIR)/.ccache


# Display the cache statistics for
cachestats:
	./$(CONFIG)/tools/cachestats | tee $(OUTPUT_DIR)/cachestats.txt


# Display the building plan for the current distribution
viewplan:
	./$(CONFIG)/tools/viewplan | tee $(OUTPUT_DIR)/viewplan-$(DEVICE).txt

plan:viewplan


# Display specified package attributes and also the dependencies' list
#	@package - package name with optional target [:<host|target|init|bootstrap>]
viewpack:
ifneq ($(package),)
	./$(CONFIG)/tools/viewpack $(package)
else
	$(error Please specify 'package' parameter!)
endif


# Display building process
viewbuild:
	./$(CONFIG)/tools/viewbuild

monitor:viewbuild


# Commit and push updated files into SVN versioning system. The 'message' input
# parameter is required.
svnrev:
ifneq ("$(wildcard $(ROOT)/.svn)","")
ifneq ($(message),)
	svn ci -m "$(message)"
else
	$(error Please specify 'message' parameter!)
endif
endif


# Commit and push updated files into GitHUB versioning system. The 'message' input
# parameter is required.
gitrev:
ifneq ("$(wildcard $(ROOT)/.git)","")
ifneq ($(message),)
	git add .
	git commit -m "$(message)"
	git push
else
	$(error Please specify 'message' parameter!)
endif
endif


# Create and push a new versioning tag equals with the addon release. The uploaded can be
# done later - manually or through a separate task and thus the tag is transformed into a
# addon release
gitrel:
ifneq ("$(wildcard $(ROOT)/.git)","")
ifneq ($(tag),)
	git tag "$(tag)"
	git push origin --tags
else
	$(error Please specify 'tag' parameter!)
endif
endif


# Commit and push changes in both versioning systems (SVN and GIT)
revision:
ifneq ("$(wildcard $(ROOT)/.svn)","")
ifneq ("$(wildcard $(ROOT)/.git)","")
ifneq ($(message),)
	$(MAKE) svnrev
	$(MAKE) gitrev
else
	$(error Please specify 'message' parameter!)
endif
endif
endif


# Publish the last build in the releases repository
release:
	$(MAKE) info -e wait=on
ifneq ("$(wildcard /tmp/.cluevars)","")
ifneq ($(TARGETS),)
	rm -rf $(TARGETS)/$(DISTRO_NAME)-$(DISTRO_VERSION)*
endif
	$(eval DISTRO_VERSION=`cat /tmp/.cluevars 2>/dev/null | grep -i "distroversion" | cut -f2 -d"="`)
ifneq ($(shell svn status -u 2>/dev/null | grep -i "^[AMD]" | wc -l),0)
	$(MAKE) revision -e message="Reporting release $(DISTRO_VERSION)"
endif
	$(eval DISTRO_GITHTAG=`git describe --abbrev=0 --tags 2>/dev/null`)
ifneq ($(DISTRO_VERSION),$(DISTRO_GITHTAG))
	$(MAKE) gitrel -e tag="$(DISTRO_VERSION)"
endif
	./$(CONFIG)/build "image" | tee $(OUTPUT_DIR)/build.log
	$(eval TARGETS=`cat /tmp/.cluevars 2>/dev/null | grep -i "localtargets" | cut -f2 -d"="`)
	$(eval IMAGE_NAME=`cat /tmp/.cluevars 2>/dev/null | grep -i "imagename" | cut -f2 -d"="`)
ifneq ($(PUBLISH),)
	echo "> Publishing release to $(PUBLISH)/$(DEVICE)/$(IMAGE_NAME).img.gz.."
	# define location and copy meta files
	mkdir -p $(PUBLISH)/$(DEVICE)
	cp -f $(TARGETS)/$(IMAGE_NAME).img.gz $(PUBLISH)/$(DEVICE)/$(IMAGE_NAME).img.gz
	python $(PUBLISH)/jsongen.py --device="$(DEVICE)" --properties=/tmp/.cluevars
	echo "> Release done.."
else
	$(error Repository location is not specified in PUBLISH variable. Set it up and try again!)
endif
else
	$(error No prior build has been done or no build initialization has performed before release creation)
endif


releaseall:
	export DEVICE=RPi
	$(MAKE) release
	export DEVICE=RPi2
	$(MAKE) release
	export DEVICE=RPi4
	$(MAKE) release


# Display the help text
help:
	echo -e "\
\nSYNOPSIS\n\
       make info | next \n\
       make clean | cleanall | build | image | install \n\
       make cachestats | viewplan | viewpack | viewbuild \n\
       make svnrev | gitrev | gitrel | revision \n\
       make release | releaseall | help \n\
\nDESCRIPTION\n\
    Executes one of the make tasks defined through this Makefile flow, according \n\
    to the specified DEVICE variable. In case is not defined/exported to the OS \n\
    level you can include it in the command line with '-e' like in the following\n\
    example: 'make build -e DEVICE=RPi4'. It is recommended to work with the OS \n\
    export variable just to avoid complex command lines: 'export DEVICE=RPi4'\n\
    All possible value of DEVICE variable are described in the README files, \n\
    providing the complete list of support devices.\n\n\
    build [-e package=<pack>]\n\
                  build one particular package (and all related dependencies) or \n\
                  the entire DEVICE distribution\n\
    info [-e wait=on|off]\n\
                  Display release setup according to the selected DEVICE. The command\n\
                  can interrupt build flow execution waiting for a key validation, \n\
                  or can exit from the process based on 'wait' parameter value.\n\
    clean [-e package=<pack> | packages=<list of packs separated by space>]\n\
                  cleanup one particular package or the entire DEVICE distribution\n\
    cleanall\n\
                  Clean-up all DEVICE distributions, cache and stamps resources as well\n\
    build [-e local=on|off package=<pack> | packages=<list of packs separated by space>]\n\
                  Build the system release for the current DEVICE in case no 'package'\n\
                  parameter is specified, otherwise will build only the indicated package(s)\n\
                  In case 'local' parameter is specified and is 'on' build version will remain\n\
                  the same\n\
    image [-e local=on|off]\n\
                  Build the system release and create OS image for the current DEVICE\n\
                  IN ase 'local' parameter is 'on' no build version is requested, will use the\n\
                  the existing one from the local file system. The variables will be generated\n\
                  by 'info' target containing the existing build version\n\
    install -e package=<pack> | packages=<list of packs separated by space>]\n\
                  install one particular package and related dependencies\n\
    cachestats\n\
                  Displays cache statistics\n\
    viewplan | plan\n\
                  Shows the building plan for the current DEVICE\n\
    viewpack\n\
                  Shows the package descriptor and properties\n\
    viewbuild | monitor\n\
                  Display the real time build process for the current DEVICE\n\
    next\n\
                  Increment release build number to indicate new release preparation\n\
    svnrev\n\
                  Commit the new release changes into SVN versioning repository.\n\
                  Attention, adding or removal to the project level have to be done\n\
                  directly from IDE\n\
    gitrev -e message=<submit message>\n\
                  Commit the new release changes into GitHUB versioning repository\n\
    gitrel -e tag=<tag name>\n\
                  Create a new release tag into GitHub versioning repository using current\n\
                  addon version (defined in the addon descriptor - addon.xml file)\n\
    revision -e message=<submit message>\n\
                  Commit and push project changes in both versioning systems (SVN and GIT)\n\
    release\n\
                  Build release and image for the current DEVICE and publish it into repository\n\
    releaseall\n\
                   Build releases and images for all supported DEVICES and publish the image\n\
                   files into the release repository\n\
      help\n\
                  Shows this text\n\
\n\
    There are couple of system variables that can be set in order to drive the building \n\
    process:\n\
    DEVICE\n\
                  Indicates the target device type. Possible options are: RPi, RPi2, RPi4\n\
                  Default value is 'RPi'.\n\
    OUTPUT\n\
                  Describes the local file system location where the build process will be  \n\
                  executed. Default value is '$(ROOT)/../Clue-out'\n\
    PUBLISH\n\
                  Indicates the remote file system where the new releases are published and stored\n\
                  This location should be attached to the local system as a network folder\n\
    STATUS\n\
                  Provides and indication about distribution build status. All possible values\n\
                  are: stable, devel, nightly, daily, weekly, monthly, Default value is 'devel'\n\
    DEBUG\n\
                  Debug compilation flag (yes/no). Default value is 'no'\n\
    VERBOSE\n\
                  Verbose compilation mode (yes/no). Default value is 'yes'\n\
\n\
EXAMPLES\n\
       build the entire distribution ('build' task is default)\n\
       > make\n\
       > make build\n\n\
       build 'sed' package\n\
       > make build -e package=sed\n\n\
       install 'sed' package (and related dependencies)\n\
       > make install -e package=sed\n\n\
       make system release and OS image\n\
       > make release\n\n\
       view the building plan (it is saved in viewplan.txt file from $(OUTPUT_DIR) folder)\n\
       > make viewplan\n\n\
" | more