Ambientes
Builds de Debug, o TestFlight e a App Store enviam para o mesmo projeto, e cada evento diz de qual veio.
Todo evento traz um environment, então um mesmo projeto pode guardar eventos de
desenvolvimento, de beta e de produção sem misturá-los. O painel mostra um ambiente por vez, ou
todos.
Os nomes
Cada SDK nomeia o ambiente do seu jeito (veja abaixo). Qualquer outro nome funciona quando é você
que o define: letras minúsculas, dígitos, - e _, até 32 caracteres, começando com uma letra
ou um dígito (staging, internal, staging-eu).
Como cada SDK o detecta
| SDK | Detecção |
|---|---|
| Swift | development para uma build de Debug ou qualquer build no simulador, testflight para uma build instalada pelo TestFlight, production nos demais casos (a App Store) |
| Android | development quando o app é depurável (toda build de debug), production nos demais casos |
| React Native, Flutter | O do SDK nativo: a regra do Swift no iOS, a do Android no Android |
| JavaScript, navegador | development em localhost, 127.0.0.1, [::1] ou num host *.localhost, production em qualquer outro lugar |
| JavaScript, Node | production quando NODE_ENV=production, development nos demais casos |
| Python, Go, JVM | A variável de ambiente LYRELOG_ENVIRONMENT, senão production |
Como sobrescrevê-lo
Defina environment na configuração do SDK. No Swift, nil mantém a detecção (null no
Android e no Flutter, undefined no React Native), então você pode combiná-la com uma regra sua:
Lyrelog.start(Configuration(
endpoint: URL(string: "https://ingest.lyrelog.com")!,
apiKey: "lyr_ing_...",
environment: isInternalTester ? "internal" : nil // nil = detected
))Lyrelog.detectedEnvironment retorna o que o SDK do Swift escolheria sozinho.
O que você roda é development
Uma build que você roda pelo Xcode, qualquer build no simulador, uma build de debug do Android
(também via React Native ou flutter run) e uma página web em localhost enviam todas
development. O painel abre em production, então escolha development (ou All
environments) na barra superior para ver os seus primeiros eventos.
A verificação do TestFlight lê o recibo da App Store da build: uma build do TestFlight tem um
recibo de sandbox. Uma build de Release que você mesmo instala (ad hoc, ou direto pelo Xcode com
a configuração Release) não tem recibo, então conta como production. Defina environment
você mesmo quando isso importar.
Via HTTP, defina resource.environment. Um evento enviado sem ele é guardado como
production.
No painel
O seletor na barra superior lista os ambientes vistos nos últimos 30 dias, com quantos eventos
cada um tem, além de All environments. A sua escolha fica salva por projeto no seu
navegador. Até você escolher um, o painel abre no ambiente padrão do projeto: production, a
menos que um proprietário o mude em Settings, onde ele também pode ser
All. Toda página sobre eventos segue o seletor. Veja
Ambientes e plataformas.
A seção Environments de Settings também mostra como o ambiente é decidido para as plataformas que o projeto tem.