mb_runner.sh

#!/bin/bash

# This is just a little helper-script to make ConnectIQ-development on UNIX-systems easier (without using the Eclipse-plugin).
#
# Based on the (Linux) ConnectIQ SDK 3.1.0
# ( https://developer.garmin.com/downloads/connect-iq/sdks/connectiq-sdk-lin-3.1.6-2019-10-23-2de4665c6.zip )
#
# The following tasks can be invoked:
#   * compiling (re)sources and building a PRG-file for testing
#   * run unit-tests (requires a running simulator)
#   * creating a signed IQ-file package for publishing
#   * cleaning up previously built files
#   * starting the ConnectIQ-simulator
#   * pushing the generated PRG-file to the running simulator
#
# Usage:
#   mb_runner.sh {build|test|package|clean|simulator|push} [full-path-to-ciq-project-root] [relative-resources-folder-path] [relative-source-folder-path]
#
# Example (for a standard project with jungle-file; script directly run from within project-root):
#   mb_runner.sh package
#
# Example (for a standard project with jungle-file; using a specified project-root):
#   mb_runner.sh package /home/achim/projects/HueCIQ
#
# Example (for a "legacy" project WITHOUT jungle file; using custom paths for root/resources/sources):
#   mb_runner.sh package /home/achim/projects/HueCIQ resources source

# **********
# env checks
# **********

[ -z "${MB_HOME}" ] && { echo "MB_HOME not set!"; exit 1; }
[ -z "${MB_PRIVATE_KEY}" ] && { echo "MB_PRIVATE_KEY not set!"; exit 1; }

# ***********
# param check
# ***********

case "${1}" in
   build|test|package|clean|simulator|push)
      ;;
   *)
      echo "Usage: `basename ${0}` {build|test|package|clean|simulator|push} [full-path-to-ciq-project-root] [relative-resources-folder-path] [relative-source-folder-path]"
      exit 1
      ;;
esac

if [ -n "${2}" ]; then
   PROJECT_HOME="${2}"
else
   PROJECT_HOME="${PWD}"
fi

if [ ! -n ${3} ]; then
   RESOURCES_FOLDER="${3}"
else
   RESOURCES_FOLDER="resources"
fi

if [ ! -n ${4} ]; then
   SOURCE_FOLDER="${4}"
else
   SOURCE_FOLDER="source"
fi

# *****************
# defaults & config
# *****************

JUNGLE_FILES=("${PROJECT_HOME}/monkey.jungle" "${PROJECT_HOME}/barrels.jungle")
TEST_JUNGLE_FILES=("${JUNGLE_FILES[@]}" "${PROJECT_HOME}/tests.jungle")
MANIFEST_FILE="${PROJECT_HOME}/manifest.xml"
CONFIG_FILE="${PROJECT_HOME}/mb_runner.cfg"

if [ ! -e "${CONFIG_FILE}" ] ; then
    echo "Config file \"${CONFIG_FILE}\" not found!"
    exit 1
else
    source "${CONFIG_FILE}"
fi

[ -z "${APP_NAME}" ] && { echo "APP_NAME not set!"; exit 1; }

# check if jungle-file(s) exist; if not prepare (re)sources manually ...

JUNGLE_FILE_EXISTS=true

for JUNGLE_FILE in ${JUNGLE_FILES}; do
    if [ ! -e "${JUNGLE_FILE}" ]; then
        JUNGLE_FILE_EXISTS=false
    fi
done

if [ "${JUNGLE_FILE_EXISTS}" = false ] ; then
    RESOURCES="`cd /; find \"${PROJECT_HOME}/${RESOURCES_FOLDER}\"* -iname '*.xml' | tr '\n' ':'`"
    SOURCES="`cd /; find \"${PROJECT_HOME}/${SOURCE_FOLDER}\" -iname '*.mc' | tr '\n' ' '`"
fi

OUT_DIR="${PROJECT_HOME}/bin"

# ******************
# sdk specific stuff
# ******************

API_DB="${MB_HOME}/bin/api.db"
PROJECT_INFO="${MB_HOME}/bin/projectInfo.xml"
API_DEBUG="${MB_HOME}/bin/api.debug.xml"
DEVICES="${MB_HOME}/bin/devices.xml"

# **********
# processing
# **********

# possible parameters ...

#PARAMS+="--apidb \"${API_DB}\" "
#PARAMS+="--buildapi "
#PARAMS+="--configs-dir <arg> "
#PARAMS+="--device \"${TARGET_DEVICE}\" "
#PARAMS+="--package-app "
#PARAMS+="--debug "
#PARAMS+="--excludes-map-file <arg> "
#PARAMS+="--import-dbg \"${API_DEBUG}\" "
#PARAMS+="--write-db "
#PARAMS+="--manifest <arg> "
#PARAMS+="--api-version <arg> "
#PARAMS+="--output \"${APP_NAME}.prg\" "
#PARAMS+="--project-info \"${PROJECT_INFO}\" "
#PARAMS+="--release "
#PARAMS+="--sdk-version \"${TARGET_SDK_VERSION}\" "
#PARAMS+="--unit-test "
#PARAMS+="--devices \"${DEVICES}\" "
#PARAMS+="--version "
#PARAMS+="--warn "
#PARAMS+="--excludes <arg> "
#PARAMS+="--private-key \"${MB_PRIVATE_KEY}\" "
#PARAMS+="--rez <arg> "

function common_params
{
  local -n JUNGLES=$1
  PARAMS+="--device \"${TARGET_DEVICE}\" "
  PARAMS+="--output \"${APP_NAME}.prg\" "
  #PARAMS+="--sdk-version \"${TARGET_SDK_VERSION}\" "
  PARAMS+="--private-key \"${MB_PRIVATE_KEY}\" "

  PARAMS+="--apidb \"${API_DB}\" "
  PARAMS+="--import-dbg \"${API_DEBUG}\" "
  PARAMS+="--project-info \"${PROJECT_INFO}\" "

  PARAMS+="--warn "

  JUNGLES=$(printf "%s;" "${JUNGLES[@]}")
  JUNGLES=${JUNGLES::-1}
  PARAMS+="--jungles $JUNGLES "
}

function params_for_test
{
  common_params TEST_JUNGLE_FILES
  PARAMS+="--unit-test "

}

function params_for_build
{
  common_params JUNGLE_FILES
}

function params_for_package
{
    if [[ -z "${GIT_TAG}" ]]; then
      GIT_TAG=$(git describe --long --dirty)
    fi

    PARAMS+="--output \"${OUT_DIR}/${APP_NAME}-${GIT_TAG}.iq\" "
    PARAMS+="--private-key \"${MB_PRIVATE_KEY}\" "

    PARAMS+="--package-app "
    PARAMS+="--release "
    PARAMS+="--warn "

    if [ "${JUNGLE_FILE_EXISTS}" = false ] ; then
        PARAMS+="--manifest \"${MANIFEST_FILE}\" "
        PARAMS+="--rez \"${RESOURCES}\" "
        PARAMS+="${SOURCES} "
    else
      JUNGLES=$(printf "%s;" "${JUNGLE_FILES[@]}")
      JUNGLES=${JUNGLES::-1}
      PARAMS+="--jungles $JUNGLES"
    fi
}

function compile
{
    "${MB_HOME}/bin/monkeyc" ${PARAMS}
}

function tests
{
    "${MB_HOME}/bin/monkeydo" "${PROJECT_HOME}/${APP_NAME}.prg" "${TARGET_DEVICE}" -t
}

function clean
{
    rm -f "${PROJECT_HOME}/${APP_NAME}"*.prg*
    rm -f "${PROJECT_HOME}/${APP_NAME}"*.iq
    rm -f "${PROJECT_HOME}/${APP_NAME}"*.json
    rm -f "${PROJECT_HOME}/sys.nfm"
}

function simulator
{
    SIM_PID=$(ps aux | grep simulator | grep -v "grep" | grep -v `basename "${0}"` | awk '{print $2}')
    [[ ${SIM_PID} ]] && kill ${SIM_PID}

    "${MB_HOME}/bin/connectiq" &
}

function push
{
    [ -e "${PROJECT_HOME}/${APP_NAME}.prg" ] && "${MB_HOME}/bin/monkeydo" "${PROJECT_HOME}/${APP_NAME}.prg" "${TARGET_DEVICE}" &
}

function prep_out_dir
{
if [ ! -d "$OUT_DIR" ]; then
  mkdir $OUT_DIR
fi
}

###

cd ${PROJECT_HOME}

case "${1}" in
   build)
        params_for_build
        compile
        ;;
   test)
        params_for_test
        compile
        tests
        ;;
   package)
        params_for_package
        prep_out_dir
        compile
        ;;
   clean)
        clean
        ;;
   simulator)
        simulator
        ;;
   push)
        push
        ;;
esac