chore: sync with microG unofficial installer

Signed-off-by: ale5000 <15793015+ale5000-git@users.noreply.github.com>

Author: ale5000-git

.gitignore

@@ -64,6 +64,7 @@ user.gradle
 /docs/devel/
 
 # Custom project folders
+/build-hooks/*.hook.sh
 /cache/
 /output/
 /recovery-simulator/output/

addition.sh

@@ -0,0 +1,76 @@
+#####################
+Hook system for build
+#####################
+
+..
+   SPDX-FileCopyrightText: 2026 ale5000
+   SPDX-License-Identifier: GPL-3.0-or-later WITH LicenseRef-Archive-packaging-exception
+   SPDX-FileType: DOCUMENTATION
+
+This directory contains optional hooks to customize the build process. Each hook
+must be a shell script named following the pattern: ``<hook_name>.hook.sh``.
+
+
+How it works
+============
+
+If a hook script exists in this folder, the build script will source (include)
+it at specific stages. Hooks run in the same shell environment as the main
+script, so they have access to all variables (like ``${TEMP_DIR:?}``,
+``${MODULE_VER:?}``, etc.).
+
+
+Available hooks
+===============
+
+#. **pre_init** Triggered after core libraries are loaded and command-line
+   parameters are parsed, but before loading configuration files. *Use case:*
+   Override logic based on the selected ``${BUILD_TYPE:?}`` or modify early
+   script flags before configurations are applied.
+
+#. **post_init** Triggered after metadata extraction (ID, Version, Author) but
+   before dependency checks. *Use case:* Dynamically modify the module version
+   or add system requirements.
+
+#. **pre_temp_create** Triggered before the temporary working directory is
+   created.
+
+#. **post_temp_create** Triggered once the temp directory is ready and cleared.
+
+#. **pre_download** Triggered before starting any external file downloads (e.g.,
+   via wget). *Use case:* Setup proxies, auth tokens, or custom download
+   mirrors.
+
+#. **pre_package** The last stage before compression. All files are ready in
+   ``${TEMP_DIR:?}/zip-content``. *Use case:* Patching files, minifying assets,
+   or injecting dynamic data.
+
+#. **post_package** Triggered after the unsigned ZIP is created, but before the
+   signing process. *Use case:* Run custom integrity checks on the raw archive.
+
+#. **post_sign** Triggered after the ZIP has been signed and zipaligned. *Use
+   case:* Generate extra checksums.
+
+#. **on_finish** Triggered after cleanup and hash calculation, just before the
+   script exits. *Use case:* Send notifications (Telegram/Discord) or upload to
+   a remote server.
+
+
+Guidelines
+==========
+
+-  **Extensions:** Files must end in ``.hook.sh``.
+-  **Exit codes:** If a hook returns a non-zero exit code, the build process
+   will be aborted immediately.
+-  **Portability:** Write hooks in POSIX-compliant shell for maximum
+   compatibility.
+
+
+Example (pre_package.hook.sh)
+=============================
+
+.. code:: sh
+
+   #!/usr/bin/env sh
+   echo 'Adding custom timestamp to info.prop...'
+   date '+%s' 1>> "${TEMP_DIR:?}/zip-content/info.prop"

build-hooks/README.rst

@@ -102,6 +102,9 @@ esac
 save_last_title
 set_title 'Building the flashable zip...'
 
+# [HOOK] pre_init: Early setup
+run_hook 'pre_init'
+
 # shellcheck source=SCRIPTDIR/conf/conf-common.inc.sh
 . "${MAIN_DIR:?}/conf/conf-common.inc.sh"
 # shellcheck source=SCRIPTDIR/conf/conf-full.inc.sh
@@ -159,6 +162,9 @@ if test "${OPENSOURCE_ONLY:?}" != 'false'; then
   if test ! -f "${MAIN_DIR:?}/zip-content/settings-oss.conf"; then ui_error 'The settings file is missing' "${LINENO-}" "${FUNCNAME-}"; fi
 fi
 
+# [HOOK] post_init: After metadata extraction but before dependency check
+run_hook 'post_init'
+
 # Check dependencies
 command 1> /dev/null 2>&1 -v 'printf' || ui_error 'Missing: printf'
 command 1> /dev/null 2>&1 -v 'zip' || ui_error 'Missing: zip'
@@ -178,13 +184,19 @@ test "${JAVA_VER:-0}" -ge 17 || ui_error 'Java 17 or later is required' "${LINEN
 # Create the output dir
 mkdir -p "${OUT_DIR:?}" || ui_error 'Failed to create the output dir'
 
+# [HOOK] pre_temp_create: Triggered before temp directory initialization
+run_hook 'pre_temp_create'
+
 # Create the temp dir
 TEMP_DIR="$(mktemp -d -t ZIPBUILDER-XXXXXX)" || ui_error 'Failed to create our temp dir'
 if test -z "${TEMP_DIR}"; then ui_error 'Failed to create our temp dir'; fi
 
 # Empty our temp dir (should be already empty, but we must be sure)
 rm -rf "${TEMP_DIR:?}"/* || ui_error 'Failed to empty our temp dir'
 
+# [HOOK] post_temp_create: Ideal for injecting custom files into the temp directory
+run_hook 'post_temp_create'
+
 # Set filename
 sanitize_filename_part()
 {
@@ -219,8 +231,8 @@ fi
 FILENAME="${FILENAME_START:?}${FILENAME_MIDDLE:?}${FILENAME_END:?}"
 FILENAME_EXT='.zip'
 
-# shellcheck source=SCRIPTDIR/addition.sh
-. "${MAIN_DIR}/addition.sh"
+# [HOOK] pre_download: Triggered before starting any external file download
+run_hook 'pre_download'
 
 # Download and verify external application files to ensure package integrity; bundled files will be verified at a later stage
 {
@@ -332,19 +344,28 @@ rm -f "${OUT_DIR:?}/${FILENAME_START:?}"*"${FILENAME_END:?}"*"${FILENAME_EXT:?}"
 rm -f "${OUT_DIR:?}/${FILENAME_START:?}"*"${FILENAME_END:?}"*"${FILENAME_EXT:?}".md5 || ui_error 'Failed to remove the previously built files' "${LINENO-}" "${FUNCNAME-}"
 rm -f "${OUT_DIR:?}/${FILENAME_START:?}"*"${FILENAME_END:?}"*"${FILENAME_EXT:?}".sha256 || ui_error 'Failed to remove the previously built files' "${LINENO-}" "${FUNCNAME-}"
 
+# [HOOK] pre_package: Last chance to modify content before zipping
+run_hook 'pre_package'
+
 # Compress (it ensure that the list of files to compress is in the same order under all OSes)
 # Note: Unicode filenames in the zip are disabled since we don't need them and also zipsigner.jar chokes on them
 cd "${TEMP_DIR}/zip-content" || ui_error 'Failed to change the folder' "${LINENO-}" "${FUNCNAME-}"
 echo 'Zipping...'
 find . -type f | LC_ALL=C sort | zip -D -9 -X -UN=n -nw "${TEMP_DIR}/flashable${FILENAME_EXT:?}" -@ || ui_error 'Failed compressing' "${LINENO-}" "${FUNCNAME-}"
 FILENAME="${FILENAME:?}-signed"
 
+# [HOOK] post_package: Triggered after compression, but before signing
+run_hook 'post_package'
+
 # Sign and zipalign
 echo ''
 echo 'Signing and zipaligning...'
 mkdir -p "${TEMP_DIR:?}/zipsign"
 java -Duser.timezone=UTC -Dzip.encoding=Cp437 -Djava.io.tmpdir="${TEMP_DIR:?}/zipsign" -jar "${MAIN_DIR:?}/tools/zipsigner.jar" "${TEMP_DIR:?}/flashable${FILENAME_EXT:?}" "${TEMP_DIR:?}/${FILENAME:?}${FILENAME_EXT:?}" || ui_error 'Failed signing and zipaligning' "${LINENO-}" "${FUNCNAME-}"
 
+# [HOOK] post_sign: Triggered after the signing process is complete
+run_hook 'post_sign'
+
 if test "${FAST_BUILD:-false}" = 'false'; then
   echo ''
   zip -T "${TEMP_DIR:?}/${FILENAME:?}${FILENAME_EXT:?}" || ui_error 'The zip file is corrupted' "${LINENO-}" "${FUNCNAME-}"
@@ -397,14 +418,16 @@ if test "${GITHUB_JOB:-false}" != 'false'; then
   } >> "${GITHUB_OUTPUT?}"
 fi
 
+set +e
 cd "${_init_dir:?}" || ui_error 'Failed to change back the folder' "${LINENO-}" "${FUNCNAME-}"
 
+# [HOOK] on_finish: Final hook for notifications or moving files to a server
+run_hook 'on_finish'
+
 echo ''
 echo 'Done.'
 set_title 'Done'
 
-set +e
-
 # Ring bell
 beep
 

build.sh

@@ -3,6 +3,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later WITH LicenseRef-Archive-packaging-exception
 
 # shellcheck enable=all
+# shellcheck disable=SC2240 # Ignore: The dot command does not support arguments in sh/dash
 # shellcheck disable=SC3028 # Ignore: In POSIX sh, FUNCNAME is undefined
 # shellcheck disable=SC3043 # Ignore: In POSIX sh, 'local' is undefined
 
@@ -118,6 +119,17 @@ ui_nl()
   printf 1>&2 '\n'
 }
 
+run_hook()
+{
+  local hook_file="${MAIN_DIR:?}/build-hooks/${1:?}.hook.sh"
+
+  if test -f "${hook_file:?}"; then
+    ui_debug "Running hook: ${1?}..."
+    # shellcheck source=/dev/null
+    . "${hook_file:?}" "${hook_file:?}" "${@}" || ui_error "Hook '${1?}' failed with exit code ${?}" "${LINENO-}" "${FUNCNAME-}"
+  fi
+}
+
 export DL_DEBUG="${DL_DEBUG:-false}"
 export http_proxy="${http_proxy-}"
 export ftp_proxy="${ftp_proxy-}"
@@ -1594,6 +1606,11 @@ init_cmdline()
     HOME="${USER_HOME:-${HOME:?}}" command -- bundle "${@}"
   }
 
+  bundler()
+  {
+    HOME="${USER_HOME:-${HOME:?}}" command -- bundler "${@}"
+  }
+
   if test "${CI:-false}" = 'false'; then
     PS1="${__DEFAULT_PS1:?}"
     PROMPT_COMMAND='__update_title_and_ps1 "${@}" || true'