@itcase/config 1.7.28 → 1.7.29

package/README.md

@@ -19,6 +19,8 @@ npm install --save-dev @itcase/config
 
 - **Smart commit** — CLI `smart-commit` (Cursor Agent → preview → commit)
 
+- **App** — скрипты в `app/`, путь `node_modules/@itcase/config/app/`. `check-sentry.sh VAR` берёт URL из `.env.defaults` или `.env`. Android-сборка читает пакет из `android/app/build.gradle` (`def appId`), debug-суффикс `.debug`, у `PROD` суффикса окружения нет.
+
 - **Husky** — общие git-хуки в `husky-hooks/`
   - В git только `.husky/config`; обёртки и `_run.sh` создаёт `itcase-config-husky-install` при `npm i`
 

package/app/android-apk-debug.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+
+# Сборка debug и установка на эмулятор или USB-устройство.
+# CLI react-native ищет app-debug.apk, поэтому APK передаём через --binary-path.
+#
+# Usage: android-apk-debug.sh device|emulator -PENV=STAGE
+#   device    первое устройство не emulator-*
+#   emulator  первый emulator-*; если нет — первый AVD
+# Иначе: ANDROID_SERIAL=xxx
+
+set -euo pipefail
+
+source "$(dirname "$0")/android-common.sh"
+
+root=$(android_repo_root)
+cd "$root"
+
+target="${1:-}"
+
+if [ "$target" != "device" ] && [ "$target" != "emulator" ] || [ -z "${2:-}" ]; then
+  echo "Usage: android-apk-debug.sh device|emulator -PENV=STAGE"
+  exit 1
+fi
+
+env_name=$(gradle_env "$2")
+app_id=$(debug_app_id "$env_name" "$root")
+
+serial=$(android_serial "$target")
+
+if [ "$target" = "emulator" ] && [ -z "$serial" ]; then
+  avd=$(emulator -list-avds | awk 'NF { print; exit }')
+  [ -n "$avd" ] || {
+    echo "Нет AVD"
+    exit 1
+  }
+  emulator -avd "$avd" -no-boot-anim >/dev/null 2>&1 &
+  adb wait-for-device
+  serial=$(require_android_serial emulator)
+elif [ -z "$serial" ]; then
+  serial=$(require_android_serial "$target")
+fi
+
+echo "→ $serial (ENV=$env_name, $app_id)"
+install_debug_apk "$env_name" "$app_id" "$serial" "$root"

package/app/android-apk-emulator-prod.sh

@@ -0,0 +1,143 @@
+#!/bin/bash
+
+# Прод на эмуляторе. Системный раздел должен быть записываемым,
+# иначе имена из URL_VAR не попадут в hosts.
+#
+# Usage: android-apk-emulator-prod.sh -PENV=PROD [-AVD=name] URL_VAR...
+#   -PENV    уходит в Gradle. У PROD в имени APK нет «PROD».
+#   -AVD     имя эмулятора. Без флага — первый AVD.
+#   URL_VAR  имена переменных из .env.defaults, по одному на комплекс
+
+set -euo pipefail
+
+source "$(dirname "$0")/android-common.sh"
+
+root=$(android_repo_root)
+cd "$root"
+
+env_flag=
+avd_name=
+url_keys=()
+for arg in "$@"; do
+  case "$arg" in
+    -PENV=*) env_flag=$arg ;;
+    -AVD=*) avd_name=${arg#-AVD=} ;;
+    *) url_keys+=("$arg") ;;
+  esac
+done
+
+if [ -z "$env_flag" ] || [ ${#url_keys[@]} -eq 0 ]; then
+  echo "Usage: android-apk-emulator-prod.sh -PENV=PROD [-AVD=name] URL_VAR..."
+  exit 1
+fi
+
+env_name=$(gradle_env "$env_flag")
+app_id=$(debug_app_id "$env_name" "$root")
+
+resolve_host() {
+  dig +time=3 +tries=1 "$1" A +short | awk '/^[0-9]+(\.[0-9]+){3}$/ { print; exit }'
+}
+
+wait_boot() {
+  adb -s "$1" wait-for-device
+  i=0
+  while [ "$i" -lt 90 ]; do
+    boot=$(adb -s "$1" shell getprop sys.boot_completed 2>/dev/null | tr -d '\r')
+    [ "$boot" = "1" ] && return 0
+    sleep 2
+    i=$((i + 1))
+  done
+  echo "Эмулятор не загрузился"
+  exit 1
+}
+
+emulator_serial() {
+  adb devices | awk '$2=="device" && $1~/^emulator-/ { print $1; exit }'
+}
+
+start_avd() {
+  local avd="$avd_name"
+  if [ -z "$avd" ]; then
+    avd=$(emulator -list-avds | awk 'NF { print; exit }')
+  elif ! emulator -list-avds | grep -qx "$avd"; then
+    echo "Нет AVD $avd"
+    exit 1
+  fi
+  [ -n "$avd" ] || {
+    echo "Нет AVD"
+    exit 1
+  }
+  echo "→ старт $avd -writable-system"
+  emulator -avd "$avd" -writable-system -no-snapshot-load -no-boot-anim >/dev/null 2>&1 &
+  adb wait-for-device
+}
+
+serial="${ANDROID_SERIAL:-}"
+[ -n "$serial" ] || serial=$(emulator_serial)
+
+if [ -n "$serial" ]; then
+  adb -s "$serial" root >/dev/null
+  if ! adb -s "$serial" shell "touch /system/etc/.rw-test && rm /system/etc/.rw-test" >/dev/null 2>&1; then
+    echo "→ перезапуск: системный раздел только для чтения"
+    adb -s "$serial" emu kill >/dev/null 2>&1 || true
+    sleep 2
+    serial=
+  fi
+fi
+
+if [ -z "$serial" ]; then
+  start_avd
+  serial=$(emulator_serial)
+  wait_boot "$serial"
+  adb -s "$serial" root
+  adb -s "$serial" remount || {
+    adb -s "$serial" disable-verity
+    adb -s "$serial" reboot
+    wait_boot "$serial"
+    adb -s "$serial" root
+    adb -s "$serial" remount
+  }
+fi
+
+host_lines=()
+host_names=()
+
+read_url_host() {
+  local value
+  value=$(env_value "$1" "$root")
+  printf '%s' "$value" | sed -E 's#^https?://##; s#/.*##; s#:.*##'
+}
+
+for key in "${url_keys[@]}"; do
+  name=$(read_url_host "$key")
+  [ -n "$name" ] || {
+    echo "Нет $key в .env.defaults"
+    exit 1
+  }
+  ip=$(resolve_host "$name")
+  [ -n "$ip" ] || {
+    echo "Не резолвится $name ($key)"
+    exit 1
+  }
+  host_names+=("$name")
+  host_lines+=("$ip $name")
+done
+
+current_hosts=$(adb -s "$serial" shell cat /system/etc/hosts | tr -d '\r')
+{
+  while IFS= read -r line; do
+    name="${line##* }"
+    skip=
+    for managed_name in "${host_names[@]}"; do
+      if [ "$name" = "$managed_name" ]; then
+        skip=1
+        break
+      fi
+    done
+    [ -n "$skip" ] || printf '%s\n' "$line"
+  done <<< "$current_hosts"
+  printf '%s\n' "${host_lines[@]}"
+} | adb -s "$serial" shell "cat > /data/local/tmp/hosts && cp /data/local/tmp/hosts /system/etc/hosts"
+
+echo "→ $serial (ENV=$env_name, $app_id, hosts)"
+install_debug_apk "$env_name" "$app_id" "$serial" "$root"

package/app/android-common.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+
+# Общие шаги для app/*.sh. Файл только подключают через source.
+
+source "$(dirname "${BASH_SOURCE[0]}")/common.sh"
+
+android_repo_root() {
+  app_root
+}
+
+gradle_env() {
+  local raw="${1:-}"
+  local name="${raw#-PENV=}"
+
+  if [ -z "$name" ] || [ "$name" = "$raw" ]; then
+    echo "Нужен -PENV=DEV|STAGE|PROD, получено: ${raw:-пусто}" >&2
+    exit 1
+  fi
+
+  printf '%s\n' "$name"
+}
+
+debug_app_id() {
+  local env_name="$1"
+  local root="$2"
+  local app_id
+
+  app_id=$(
+    awk -F'"' '/^[[:space:]]*def appId = / { print $2; exit }' \
+      "$root/android/app/build.gradle"
+  )
+  [ -n "$app_id" ] || {
+    echo "Не найден appId в android/app/build.gradle" >&2
+    exit 1
+  }
+
+  # Как defaultConfig: PROD без суффикса окружения, debug всегда .debug.
+  if [ "$env_name" != "PROD" ]; then
+    app_id="${app_id}.${env_name}"
+  fi
+
+  printf '%s\n' "${app_id}.debug"
+}
+
+android_serial() {
+  local target="$1"
+
+  if [ -n "${ANDROID_SERIAL:-}" ]; then
+    printf '%s\n' "$ANDROID_SERIAL"
+    return
+  fi
+
+  if [ "$target" = "device" ]; then
+    adb devices | awk '$2=="device" && $1!~/^emulator-/ { print $1; exit }'
+    return
+  fi
+
+  adb devices | awk '$2=="device" && $1~/^emulator-/ { print $1; exit }'
+}
+
+require_android_serial() {
+  local target="$1"
+  local serial
+
+  serial=$(android_serial "$target")
+  if [ -z "$serial" ]; then
+    if [ "$target" = "device" ]; then
+      echo "Нет устройства:"
+    else
+      echo "Нет эмулятора:"
+    fi
+    adb devices
+    exit 1
+  fi
+
+  printf '%s\n' "$serial"
+}
+
+install_debug_apk() {
+  local env_name="$1"
+  local app_id="$2"
+  local serial="$3"
+  local root="$4"
+  local apk_dir="$root/android/app/build/outputs/apk/debug"
+  local apk
+
+  (cd "$root/android" && ./gradlew assembleDebug -x lint -PENV="$env_name")
+
+  if ls "$apk_dir"/*"$env_name"*.apk >/dev/null 2>&1; then
+    apk=$(ls -t "$apk_dir"/*"$env_name"*.apk | head -1)
+  else
+    apk=$(
+      ls -t "$apk_dir"/*.apk |
+        awk '!/STAGE/ && !/DEV/ && !/BETA/ { print; exit }'
+    )
+  fi
+
+  [ -n "$apk" ] || {
+    echo "APK не найден"
+    exit 1
+  }
+
+  (cd "$root" && npx react-native run-android --device "$serial" --binary-path "$apk" --appId "$app_id")
+}

package/app/android-perfetto.sh

@@ -0,0 +1,133 @@
+#!/bin/bash
+
+set -euo pipefail
+
+source "$(dirname "$0")/android-common.sh"
+
+print_help() {
+  echo "Пишет Perfetto-трейс с подключённого Android-устройства."
+  echo
+  echo "Пока команда не закончилась, на устройстве откройте приложение"
+  echo "или сделайте жест, который хотите разобрать (чипы, переход экрана)."
+  echo "Файл откройте на https://ui.perfetto.dev"
+  echo
+  echo "Usage: android-perfetto.sh device|emulator -PENV=STAGE [TRACE_SECONDS] [output.pftrace]"
+  echo
+  echo "  device|emulator  USB-терминал или уже запущенный эмулятор"
+  echo "  -PENV            пакет debug для этого окружения"
+  echo "  TRACE_SECONDS    длина записи, по умолчанию 15"
+  echo
+  echo "Холодный старт: перед запуском adb shell am force-stop <пакет>,"
+  echo "затем в окне записи откройте приложение с иконки."
+}
+
+if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
+  print_help
+  exit 0
+fi
+
+target="${1:-}"
+TRACE_SECONDS="${3:-15}"
+OUTPUT_FILE="${4:-trace.pftrace}"
+REMOTE_PATH="/data/misc/perfetto-traces/trace.pftrace"
+
+if [[ "$target" != "device" && "$target" != "emulator" ]] || [[ -z "${2:-}" ]]; then
+  print_help
+  exit 1
+fi
+
+env_name=$(gradle_env "$2")
+APP_ID=$(debug_app_id "$env_name" "$(android_repo_root)")
+
+serial=$(require_android_serial "$target")
+export ANDROID_SERIAL="$serial"
+echo "→ $serial"
+
+if ! [[ "$TRACE_SECONDS" =~ ^[0-9]+$ ]] || [[ "$TRACE_SECONDS" -lt 1 ]]; then
+  echo "TRACE_SECONDS должно быть числом больше 0, получено: $TRACE_SECONDS"
+  exit 1
+fi
+
+DURATION_MS=$((TRACE_SECONDS * 1000))
+
+# Android 11 (API 30, SL20) не знает поля Perfetto, которые есть на эмуляторе с Android 12+.
+SDK="$(adb shell getprop ro.build.version.sdk | tr -d '\r')"
+FTRACE_EXTRA=""
+SYS_STATS_EXTRA=""
+FRAME_TIMELINE=""
+if [[ "$SDK" -ge 31 ]]; then
+  FTRACE_EXTRA="
+      symbolize_ksyms: true
+      disable_generic_events: true"
+  SYS_STATS_EXTRA="
+      cpufreq_period_ms: 250"
+  FRAME_TIMELINE="
+data_sources {
+  config {
+    name: \"android.surfaceflinger.frametimeline\"
+  }
+}"
+fi
+
+CONFIG=$(cat <<EOF
+buffers {
+  size_kb: 131072
+  fill_policy: DISCARD
+}
+data_sources {
+  config {
+    name: "linux.ftrace"
+    ftrace_config {
+      ftrace_events: "sched/sched_switch"
+      ftrace_events: "sched/sched_wakeup"
+      ftrace_events: "sched/sched_waking"
+      ftrace_events: "sched/sched_blocked_reason"
+      ftrace_events: "power/cpu_frequency"
+      ftrace_events: "power/cpu_idle"
+      ftrace_events: "ftrace/print"
+      atrace_categories: "gfx"
+      atrace_categories: "input"
+      atrace_categories: "view"
+      atrace_categories: "wm"
+      atrace_categories: "am"
+      atrace_categories: "dalvik"
+      atrace_categories: "adb"
+      atrace_categories: "binder_driver"${FTRACE_EXTRA}
+      atrace_apps: "$APP_ID"
+    }
+  }
+}
+data_sources {
+  config {
+    name: "linux.process_stats"
+    process_stats_config {
+      scan_all_processes_on_start: true
+    }
+  }
+}
+data_sources {
+  config {
+    name: "linux.sys_stats"
+    sys_stats_config {
+      stat_period_ms: 250
+      stat_counters: STAT_CPU_TIMES${SYS_STATS_EXTRA}
+    }
+  }
+}${FRAME_TIMELINE}
+duration_ms: $DURATION_MS
+EOF
+)
+
+LOCAL_CONFIG="$(mktemp)"
+trap 'rm -f "$LOCAL_CONFIG"' EXIT
+
+printf '%s\n' "$CONFIG" > "$LOCAL_CONFIG"
+
+echo "Запись ${TRACE_SECONDS} с для $APP_ID"
+echo "Сейчас откройте приложение или переключите экран. Окно закроется само."
+# Конфиг в stdin: на части ТСД нет /data/misc/perfetto-configs, push туда даёт Permission denied.
+adb shell perfetto -c - --txt -o "$REMOTE_PATH" < "$LOCAL_CONFIG"
+
+echo "Скачиваю ./$OUTPUT_FILE"
+adb pull "$REMOTE_PATH" "$OUTPUT_FILE"
+echo "Готово: $OUTPUT_FILE — откройте на https://ui.perfetto.dev"

package/app/check-sentry.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# Проверяет, что URL из .env.defaults (или .env) отвечает.
+#
+# Usage: check-sentry.sh VAR
+#   VAR  имя переменной, например SENTRY_URL
+
+set -euo pipefail
+
+source "$(dirname "$0")/common.sh"
+
+root=$(app_root)
+cd "$root"
+
+key="${1:-}"
+if [ -z "$key" ]; then
+  echo "Usage: check-sentry.sh VAR"
+  exit 1
+fi
+
+url=$(env_value "$key" "$root")
+
+[ -n "$url" ] || {
+  echo "Нет $key в .env.defaults"
+  exit 1
+}
+curl -kI --connect-timeout 8 --max-time 20 -sS -o /dev/null "$url" || {
+  echo "Sentry недоступен: $url"
+  exit 1
+}

package/app/common.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+
+# Общие шаги для скриптов приложения. Файл только подключают через source.
+# Запускать из корня приложения: каталог пакета в node_modules — не корень.
+
+app_root() {
+  pwd
+}
+
+env_value() {
+  local key="$1"
+  local root="$2"
+  local files=()
+  local missing=()
+
+  if [ -f "$root/.env.defaults" ]; then
+    files+=("$root/.env.defaults")
+  else
+    missing+=("$root/.env.defaults")
+  fi
+  if [ -f "$root/.env" ]; then
+    files+=("$root/.env")
+  else
+    missing+=("$root/.env")
+  fi
+  if [ ${#missing[@]} -gt 0 ]; then
+    echo "Нет ${missing[*]}" >&2
+  fi
+  [ ${#files[@]} -gt 0 ] || exit 1
+
+  awk -F= -v key="$key" '
+    $1 == key { value = substr($0, index($0, "=") + 1) }
+    END { print value }
+  ' "${files[@]}" | tr -d "\"'"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itcase/config",
-  "version": "1.7.28",
+  "version": "1.7.29",
   "author": "ITCase",
   "description": "ITCase Config",
   "engines": {
@@ -25,6 +25,7 @@
     "url": "https://github.com/ITCase/itcase-config.git"
   },
   "files": [
+    "app",
     "commitlint",
     "husky-hooks",
     "lint-staged",