Leandro Carneiro Leite

dynaquiz/.gitignore

@@ -0,0 +1,21 @@
+*.iml
+.kotlin
+.gradle
+.editorconfig
+**/build/
+xcuserdata
+!src/**/build/
+local.properties
+.idea
+.DS_Store
+captures
+.externalNativeBuild
+.cxx
+*.xcodeproj/*
+!*.xcodeproj/project.pbxproj
+!*.xcodeproj/xcshareddata/
+!*.xcodeproj/project.xcworkspace/
+!*.xcworkspace/contents.xcworkspacedata
+**/xcshareddata/WorkspaceSettings.xcsettings
+node_modules/
+ios-build.log

dynaquiz/DECISIONS.md

@@ -0,0 +1,28 @@
+## Uso de Channel em eventos one-shot
+
+```kotlin
+private val _events = Channel<SplashEvent>(Channel.BUFFERED)
+val events = _events.receiveAsFlow()
+```
+
+ Padrão recomendado pela comunidade e pelo próprio Google para garantir que o evento seja consumido exatamente uma vez, mesmo com mudanças de configuração ou quando o app vai para background
+
+ ## Intent iniciais em Screens
+
+ Não costumo deixar intents serem executadas por default em um `ViewModel`. Gosto de, explicitamente, chamar uma intent usando um `onIntent()` inicial para ajudar na visibilidade futura do código, tentando diminuir o número de "mágicas" que ocorrem no código.
+
+ ## Apenas um PNG com resolução suficiente em `drawable`
+
+ Para facilitar a geração de resources, vou usar apenas um *.png com resolução suficiente para funcionar bem na aparesentação/uso da maioria dos dispositivos
+
+## Uso de commonTest
+Optei por usar commonTest tendo consciência do trade-off entre ter testes de UI rodando em nível unit e não instrumentado vs ter testes de UI rodando instrumentado apenas no Android. Minha ideia é ter validação de qualidade de forma automática também no iOS e apoiar qualquer verificação instrumentada utilizando testes manuais direto nos aparelhos Google Pixel 7 Pro e iPhone Air 17.
+
+## Detekt fora do projeto
+A compatibilidade do detekt com Kotlin 2.x só veio nas versões alpha. As versões estáveis não possuem esse suporte, então opto por deixar de fora essa lib e manter apenas o ktlint.
+
+## Usar portrait no AndroidManifest
+Decidi manter a definição de portrait na MainActivity pelo AndroidManifest mesmo com o warning novo do Android Studio/Lint indicando que travar orientação dessa forma deixou de ser a direção recomendada por causa das mudanças do Android 16 em telas grandes.
+
+## Compose Stability
+Mantive os modelos de domain livres de qualquer dependência de androidx (UI), removendo @Immutable da implementação. Decidi usar Compose Stability para que o Compose pule recomposição dos @Composables que recebem esses modelos diretamente fora de um UiState (Immutable), como RankingEntryCard, QuestionCard, FinalScorePanel, ChallengeModeOption e PlayingContent.

dynaquiz/LEARNING.md

@@ -0,0 +1,69 @@
+## Q&A
+
+Como se gerencia dependências no KMP?
+> A forma de gerenciar dependências é a mesma. Cataloga em `gradle/libs.versions.toml` e declara o uso em `composeApp/build.gradle.kts`
+
+Quem é darwin em `iosMain.dependencies { implementation(libs.ktor.client.darwin) }`?
+> A lib Darwin usada pelo Ktor no iOS é o mecanismo nativo de cliente HTTP do Kotlin/Native que utiliza a infraestrutura de rede da Apple, especificamente a NSURLSession
+
+Qual a lib que monitora e reporta crashes no KMP?
+> Sentry KMP
+
+Onde coloco os resources do projeto Android?
+> androidMain/res
+
+## TBD
+
+**Splash nativa no Android:**
+- Lib androidx-core-splashscreen
+- Criar theme
+- Substituir theme na Activity launcher
+- `installSplashScreen()` antes de `super.onCreate()` na Activity launcher 
+
+**Modificadores `expect` e `actual`:**
+Expect: declara assinatura (nome, params, retorno) sem corpo. Cada source set de plataforma é **OBRIGADO** a fornecer um actual correspondente, senão o build falha. Funciona como um "contrato" multiplatforma.
+
+Actual: repete a assinatura do expect (precisa bater exatamente — params, retorno, modificadores) e fornece o corpo. Manter o mesmo nome dos arquivo nos source sets facilita pra IDE encontrar, mas não é obrigatório.
+
+**SQLDelight e Adapters**
+O SQLDelight possui uma interface `ColumnAdapter` para adaptar valores de objetos para valores de entidades do BD. Você implementa essa interface (como em `ChallengeModeAdapter`) e ao declarar um campo de uma tabela com AS (como em `QuizSession.sq`), a Entity correspondente será gerada com uma classe interna `Adapter` pronta para receber o código preparado para converter os dois tipos.
+
+**Res e strings**
+Para padronizar strings e não usar hardcoded nos `@Composable`, usar `composeResources/values/strings.xml` e importar `Res` para acessar `Res.string.<nome>`.
+A quantidade de imports é terrível, então provavelmente eu usarei uma classe wrapper.
+
+No caso da configuração do client http:
+> Compose app
+```kotlin
+internal expect fun httpClientEngine(): HttpClientEngine
+```
+
+> Android app
+```kotlin
+internal actual fun httpClientEngine(): HttpClientEngine = OkHttp.create()
+```
+
+> iOS app
+```kotlin
+internal actual fun httpClientEngine(): HttpClientEngine = Darwin.create()
+```
+
+## iOS
+
+O gerenciamento de "resources" (chamados Assets) é feito em `Assets.xcassets`
+
+Info.plist é um arquivo de metadados configurações fundamentais de um aplicativo, funcionando como um dicionário de pares chave-valor
+
+A cor de background da ViewController launcher tem seu próprio asset em`LaunchBackground.colorset/` e seu conteúdo em `Content.json`
+
+Tive que, explicitamente, adicionar a `libsqlite3` pelo XCode em `iosApp > TARGETS > General > Frameworks, Libraries, and Embedded Content` para poder compilar o projeto no iOS.
+
+Para travar a orientação em portrair, ir pelo XCode em target > General > Deployment Info > seção Device Orientation e desmarcar as opções alternativas a portrair no iPhone
+
+Aparentemente, existe um problema com a primeira interação com um TextField no seu primeiro após uma instalação fresh ao app. O iOS bloqueia a main thread por um tempo enquanto inicializa serviços per-app do subsistema de texto. Esses caches são mantidos em diretórios privados do app dentro de ~/Library/Keyboard/ no sandbox, então sobrevivem ao kill do processo (não reproduz após swipe-up no app switcher) mas são apagados em uma reinstalação.
+
+## Aprendizagem futura:
+
+1. Como se comporta um projeto multi módulo no KMP?
+2. É possível fazer `build-logic`/convention plugins em arquitetura multi módulo no KMP?
+3. O que acontece com o app quando muda de orientação no KMP/iOS?