Plataformas
Um projeto pode reunir um app, o site dele e o backend, e o painel consegue mostrar cada um separadamente.
Um projeto pode receber eventos de várias partes de um produto: o app iOS de um jogo, o site e a
API dele podem todos enviar para um único projeto. Assim dá para acompanhar uma pessoa (pelo
user_id) entre eles, e o painel continua podendo mostrar uma parte de cada vez.
Isso tem dois lados: o campo platform em cada evento e a lista de plataformas que você
configura no projeto.
A plataforma de cada evento
Todo evento traz um platform: qual parte do produto o enviou. Os SDKs enviam:
| SDK | Plataforma |
|---|---|
| Swift | O sistema operacional: ios, macos, tvos ou visionos; apple no watchOS |
| Android | android |
| React Native, Flutter | O sistema operacional, informado pelo SDK nativo que fica por baixo: ios ou android |
| JavaScript | web num navegador, node no Node |
| Python | python |
| Go | go |
| JVM (Java e Kotlin) | jvm |
Sobrescreva-a na configuração quando um nome disser mais, por exemplo platform: "api" para o
seu backend e platform: "worker" para um consumidor de fila. A regra de nomes é a mesma dos
ambientes: letras minúsculas, dígitos, - e _, até 32.
Quando um evento chega sem plataforma, o servidor deduz uma a partir do nome do SDK e do sistema
operacional (lyrelog-swift no iOS é ios, lyrelog-js com os_name: "web" é web) ou,
na falta disso, do próprio nome do sistema operacional.
As plataformas do projeto
Em Settings, a seção Platforms lista o que envia eventos para o projeto, com um card para cada um dizendo o que é:
| Plataforma | O que você informa ao Lyrelog | O que o Lyrelog faz com isso |
|---|---|---|
| App iOS, app Mac | A página dele na App Store: busque pelo nome ou cole o link | Mostra o nome do app, o desenvolvedor, a avaliação, a versão e o bundle id |
| App Android | O pacote dele no Google Play (com.example.app) ou o link do Play | Busca o nome e o ícone do app no Google Play |
| Site | O endereço dele (example.com) | Busca o ícone do site |
| Servidor | A linguagem dele: Node, Python, Go, Java, Kotlin, Swift, Ruby, PHP, .NET, Rust, Elixir ou Other | Mostra as regras de ambiente correspondentes |
Os ícones encontrados assim podem virar o ícone do projeto (Icon em Settings). Remover uma plataforma descarta o que o Lyrelog sabia sobre ela, incluindo o ícone. A página da App Store sai quando não sobra nem um app iOS nem um app Mac.
Quando eventos dos últimos 30 dias vêm de plataformas que o projeto ainda não lista, Settings
avisa e oferece Add them. As plataformas dos eventos correspondem às do projeto assim:
ios, tvos e visionos são um app iOS, macos um app Mac, android um app Android, web
um site, e api, node, python, go e jvm um servidor (com a linguagem, quando ela é
conhecida). Um site ou um app Android abre como um card a preencher, já que precisa do endereço
ou do pacote.
Só os proprietários podem alterar as plataformas.
Filtrar por plataforma
- Barra superior: quando um projeto recebe eventos de mais de uma plataforma, o seletor de ambiente ganha uma seção Platform que lista cada plataforma de evento vista nos últimos 30 dias, além de All platforms. A escolha fica salva por projeto no seu navegador e vale para todas as páginas. Veja Ambientes e plataformas.
- Explorer: o filtro Platform aceita um ou vários valores, ou os exclui ("Platform is not web").
Os dois filtram pelo platform de cada evento, não pela lista do projeto.