После релиза: аналитика, крэши, отзывы

// в подложке: заглушка expo-updates, данные сборки из магазина и часы примера
declare const updates: { updateId: string; channel: string; runtimeVersion: string; isEmbeddedLaunch: boolean };
declare const build: { version: string; buildNumber: number; platform: string };
declare function now(): string;

interface Event { name: string; at: string; props: Record<string, string | number> }

// общие поля пришиваются в одном месте: на каждом вызове про них забудут
function context(): Record<string, string | number> {
  return {
    app_version: build.version,
    build_number: build.buildNumber,
    platform: build.platform,
    runtime_version: updates.runtimeVersion,
    channel: updates.channel,
    update_id: updates.isEmbeddedLaunch ? "embedded" : updates.updateId,
  };
}

const events: Event[] = [];

function track(name: string, props: Record<string, string | number> = {}): void {
  events.push({ name, at: now(), props: { ...context(), ...props } });
}

track("rest_timer_finish", { seconds: 90 });
// телефон откатился на вшитый бандл — и то же самое событие уходит второй раз
updates.isEmbeddedLaunch = true;
track("rest_timer_finish", { seconds: 60 });

for (const e of events) console.log(e.at, e.name, e.props);
console.log("версий в магазине:", new Set(events.map((e) => e.props.app_version)));
console.log("разного кода:", new Set(events.map((e) => e.props.update_id)));

// контекст берётся один раз за запуск: до перезапуска эти значения не меняются
import Constants from "expo-constants";
import * as Updates from "expo-updates";

export function analyticsContext(): Record<string, string | number> {
  return {
    app_version: Constants.expoConfig?.version ?? "?",
    runtime_version: Updates.runtimeVersion ?? "?",
    // null в разработке и в Expo Go: там канала у сборки нет вовсе
    channel: Updates.channel ?? "development",
    update_id: Updates.updateId ?? "none",
    // вшитый бандл — это тоже «какой код запущен», и у него нет updateId
    embedded: Updates.isEmbeddedLaunch ? 1 : 0,
    // редкий случай: обновление не встало, и приложение запустилось на вшитом
    emergency: Updates.isEmergencyLaunch ? 1 : 0,
  };
}

// в подложке: рубильник сети и приёмник событий на той стороне
interface Event { id: string; name: string }
declare function sendBatch(batch: Event[]): Promise<void>;
declare function setOnline(value: boolean): void;
declare function acceptedIds(): string[];

const BATCH = 3;
const LIMIT = 5;
const queue: Event[] = [];
let counter = 0;

function track(name: string): void {
  // id события рождается на телефоне — как opId у операций журнала в главе 6
  queue.push({ id: "ev-" + ++counter, name });
  // переполнение выбрасывает самое старое: аналитика имеет право терять
  if (queue.length > LIMIT) queue.shift();
}

async function flush(): Promise<void> {
  if (queue.length === 0) return;
  const batch = queue.slice(0, BATCH);
  try {
    await sendBatch(batch);
    // очередь чистится ПОСЛЕ ответа и ровно на длину пачки: в неё успели дописать
    queue.splice(0, batch.length);
    console.log("ушло", batch.length, "| осталось", queue.length);
  } catch (err) {
    console.log("не ушло:", (err as Error).message, "| в очереди", queue.length);
  }
}

(async () => {
  track("app_open");
  track("set_done");
  await flush();
  setOnline(false);
  for (const name of ["set_done", "set_done", "rest_timer_finish", "set_done", "set_done", "rest_timer_finish", "workout_finish"]) {
    track(name);
  }
  await flush();
  setOnline(true);
  await flush();
  await flush();
  console.log("на сервере:", acceptedIds().join(" "));
  console.log("потеряно:", counter - acceptedIds().length);
})();

// сокращено из приложения автора: shared/analytics/analytics.ts
function send(what: string, action: (target: AnalyticsClient) => Promise<void>): void {
  const target = analytics();
  if (!target) return;
  try {
    // гасятся оба отказа: исключение на месте и отвалившийся промис
    void action(target).catch((error: unknown) => log(`не отправлено: ${what}`, error));
  } catch (error) {
    log(`не отправлено: ${what}`, error);
  }
}

# карту просят флагом: без него expo export её не пишет
npx expo export --platform android --source-maps

# карта ложится рядом с бандлом и называется так же, плюс .map
# адрес из отчёта — строка и смещение: их и спрашивают у карты
npx metro-symbolicate dist/<бандл>.hbc.map 1 284531

// в подложке: отчёт с телефона и карты двух обновлений
interface Entry { at: number; name: string; source: string }
declare const crashOnPhone: { updateId: string; message: string; stack: string };
declare const maps: Record<string, Entry[]>;

// сокращение выражения из parseHermesStack (react-native 0.86): имя функции,
// затем либо (native), либо (address at файл:строка:смещение)
const FRAME = /^ {4}at (.+?)(?: \((native)\)| \((?:address at )?(.+?):(\d+):(\d+)\))$/;

// карта отсортирована по смещению: нужен последний отрезок, начавшийся не позже адреса
function lookup(map: Entry[], offset: number): Entry | undefined {
  return map.filter((e) => e.at <= offset).at(-1);
}

function symbolicate(stack: string, map: Entry[]): string[] {
  return stack.split("\n").map((line) => {
    const frame = FRAME.exec(line);
    if (!frame) return line + " ← кадр не разобран";
    if (frame[2] === "native") return frame[1] + " ← нативный кадр";
    const entry = lookup(map, Number(frame[5]));
    return entry ? entry.name + " ← " + entry.source : frame[1] + " ← адрес вне карты";
  });
}

console.log(crashOnPhone.message);
console.log("картой своего обновления, " + crashOnPhone.updateId + ":");
for (const line of symbolicate(crashOnPhone.stack, maps[crashOnPhone.updateId])) console.log("  " + line);
console.log("картой прошлого обновления, upd-0911:");
for (const line of symbolicate(crashOnPhone.stack, maps["upd-0911"])) console.log("  " + line);

// ErrorUtils — глобаль самого React Native: её ставит полифил error-guard
// ещё до загрузки модулей, поэтому обработчик видит и падения на старте.
const previous = ErrorUtils.getGlobalHandler();

ErrorUtils.setGlobalHandler((error: unknown, isFatal: boolean) => {
  // При isFatal процесс сейчас закроется, и отправить отчёт по сети уже некогда:
  // его кладут на диск, а отправляют при следующем запуске — как события в очереди.
  saveCrashToDisk({
    ...analyticsContext(),
    fatal: isFatal ? 1 : 0,
    message: String((error as Error).message),
    stack: String((error as Error).stack),
  });
  // прежний обработчик рисует красный экран в разработке и роняет процесс в проде
  previous(error, isFatal);
});

// в подложке: отчёты за сутки после раскатки и число сессий по обновлениям
interface Crash { installId: string; updateId: string; message: string; frames: string[] }
declare const crashes: Crash[];
declare const sessions: Record<string, number>;

// Подпись: сообщение без переменных частей плюс три верхних кадра. Без неё
// "database is locked (row s-1005)" и "…(row s-1096)" — две разные причины.
// Форма самого сообщения условная: движки формулируют TypeError по-разному,
// а подписи важна неизменность текста между отчётами, а не слова движка.
function signature(c: Crash): string {
  return c.message.replace(/\d+/g, "#") + " @ " + c.frames.slice(0, 3).join(" < ");
}

interface Group { count: number; installs: Set<string>; updates: Set<string> }

const groups = new Map<string, Group>();
for (const c of crashes) {
  const key = signature(c);
  const group = groups.get(key) ?? { count: 0, installs: new Set<string>(), updates: new Set<string>() };
  group.count += 1;
  group.installs.add(c.installId);
  group.updates.add(c.updateId);
  groups.set(key, group);
}

// чинят то, что задело больше людей, а не то, что дало больше отчётов
for (const [key, g] of [...groups].sort((a, b) => b[1].installs.size - a[1].installs.size)) {
  console.log(g.installs.size + " устройств, " + g.count + " отчётов | " + [...g.updates].join(", "));
  console.log("   " + key);
}

for (const [id, total] of Object.entries(sessions)) {
  const bad = crashes.filter((c) => c.updateId === id).length;
  console.log(id + ": сессий " + total + ", падений " + bad + " → без падений " + (100 - (bad / total) * 100).toFixed(1) + "%");
}

const onlyRollout = [...groups].filter(([, g]) => g.updates.size === 1 && g.updates.has("upd-0917"));
console.log("причин только на раскатке:", onlyRollout.length);

// expo-store-review: в проекте автора этого пакета нет, листинг — по документации SDK 57
import * as StoreReview from "expo-store-review";

export async function askForReview(): Promise<void> {
  // это проверка «API есть на этой платформе», а не «окно покажут»
  if (!(await StoreReview.isAvailableAsync())) return;
  // ответа нет: показали окно или нет — функция об этом не сообщает
  await StoreReview.requestReview();
}

// в подложке: дни жизни приложения у одного человека
interface Day { day: number; workouts: number; crashed: boolean }
declare const timeline: Day[];

let lastAsk: number | null = null;

// Окно оценки рисует система: она вправе не показать ничего и не сказать об этом.
// Поэтому отмечаем ПОПЫТКУ, а не показ.
function decide(d: Day): string {
  if (d.day < 7) return "рано: приложению меньше недели";
  if (d.workouts < 3) return "рано: меньше трёх законченных тренировок";
  if (d.crashed) return "не сегодня: приложение падало";
  if (lastAsk !== null && d.day - lastAsk < 120) return "просили " + (d.day - lastAsk) + " дней назад";
  return "просим";
}

for (const d of timeline) {
  const verdict = decide(d);
  if (verdict === "просим") lastAsk = d.day;
  console.log("день", d.day, "→", verdict);
}

// а если бы отметку ставили по факту показа окна, а система его не показала
lastAsk = null;
console.log("день 40, отметка по показу →", decide(timeline[4]));