expect/actual frente a interfaces

interface Platform {            // el contrato: algo que sabe decir su nombre
    val name: String
}
 
expect fun currentPlatform(): Platform   // la promesa: sin cuerpo; cada plataforma dirá cómo

package com.sebastiannarvaez.pokedex
 
import android.os.Build
 
private class AndroidPlatform : Platform {
    override val name: String = "Android ${Build.VERSION.SDK_INT}"
}
 
actual fun currentPlatform(): Platform = AndroidPlatform()

package com.sebastiannarvaez.pokedex
 
import platform.UIKit.UIDevice
 
private class IosPlatform : Platform {
    override val name: String =
        UIDevice.currentDevice.systemName() + " " + UIDevice.currentDevice.systemVersion
}
 
actual fun currentPlatform(): Platform = IosPlatform()

e: …/Platform.kt:22:1 The 'expect' declaration 'currentPlatform' has no 'actual' declaration in module '<commonMain> for JVM'.

// commonMain: la promesa. No sabe nada de iOS.
expect class PantallaBase()
 
// iosMain: el cumplimiento. Aquí sí se puede nombrar UIViewController.
actual class PantallaBase actual constructor() : UIViewController(nibName = null, bundle = null)

class Saludo(private val nombre: () -> String) {   // en vez de una interfaz, una función sin parámetros que devuelve texto
    fun frase(): String = "Hola desde ${nombre()}"   // la llama cuando la necesita
}
 
Saludo { "Plataforma de prueba" }.frase()          // en el test: una lambda de una línea; devuelve «Hola desde Plataforma de prueba»

import kotlin.test.Test
import kotlin.test.assertEquals
 
// El contrato: cualquier cosa que sepa decir qué hora es.
interface Reloj {
    val hora: Int                          // de 0 a 23
}
 
// Recibe el reloj por el constructor: no sabe si es el del móvil o uno de mentira.
class Saludador(private val reloj: Reloj) {
    fun saludo(): String =
        if (reloj.hora < 12) "Buenos días" else "Buenas tardes"
}
 
// En el test: un reloj de mentira, de una línea, que marca la hora que le digas.
private class RelojFalso(override val hora: Int) : Reloj
 
class SaludadorTest {
 
    @Test
    fun porLaMananaDiceBuenosDias() {
        assertEquals("Buenos días", Saludador(RelojFalso(9)).saludo())   // a las 9, «Buenos días»
    }
 
    @Test
    fun porLaTardeDiceBuenasTardes() {
        assertEquals("Buenas tardes", Saludador(RelojFalso(15)).saludo()) // a las 15, «Buenas tardes»
    }
}

org.junit.ComparisonFailure: expected:<Buen[os día]s> but was:<Buen[as tarde]s>

kotlin.AssertionError: Expected <Buenos días>, actual <Buenas tardes>.

package com.sebastiannarvaez.pokedex
 
/**
 * El nombre y la version del sistema donde corre este codigo.
 *
 * Es una interfaz y no una `expect class` a proposito. JetBrains desaconseja
 * las clases `expect` cuando basta una interfaz, y la razon practica se ve en
 * los tests: de una interfaz se escribe una implementacion falsa en tres
 * lineas, y de una `expect class` no se puede.
 */
interface Platform {
    val name: String
}
 
/**
 * Una de las fronteras `expect` del modulo (la otra es `ioDispatcher()`).
 *
 * No se llama desde el codigo de dominio: la llama quien arranca la app, una
 * sola vez, y a partir de ahi la `Platform` viaja como parametro. Cuantas menos
 * llamadas tenga esta funcion, menos codigo queda atado a la plataforma.
 */
expect fun currentPlatform(): Platform

package com.sebastiannarvaez.pokedex
 
import com.sebastiannarvaez.pokedex.core.Log
 
/**
 * La prueba de humo del proyecto: si esta frase aparece en las dos pantallas,
 * el codigo compartido esta llegando a Android y a iOS.
 *
 * Recibe la `Platform` en vez de pedirsela a `currentPlatform()`. Es la
 * diferencia entre una clase que se puede probar y una que no: en un test se le
 * pasa una implementacion falsa y el resultado deja de depender de donde corra.
 */
class Greeting(private val platform: Platform) {
 
    fun greet(): String {
        val saludo = "Hola desde ${platform.name}"
        // La misma linea de codigo acaba en Logcat y en la consola de Xcode.
        Log.i(saludo)
        return saludo
    }
}

package com.sebastiannarvaez.pokedex
 
import kotlin.test.Test
import kotlin.test.assertEquals
import kotlin.test.assertTrue
 
/**
 * Una plataforma de mentira. Tres lineas, sin libreria de mocks.
 *
 * Los mocks por reflexion no funcionan en Kotlin/Native, asi que en KMP los
 * dobles se escriben a mano. No es un apano: es lo que recomienda hacer.
 */
private class FakePlatform(override val name: String) : Platform
 
class GreetingTest {
 
    @Test
    fun elSaludoNombraLaPlataformaQueSeLePasa() {
        // Sin la interfaz, este test no se podria escribir: diria una cosa en
        // la JVM, otra en Android y otra en el simulador de iOS.
        val saludo = Greeting(FakePlatform("Plataforma de prueba")).greet()
 
        assertEquals("Hola desde Plataforma de prueba", saludo)
    }
 
    @Test
    fun cadaPlataformaRealSeIdentifica() {
        // Este si depende de donde corra, y por eso solo comprueba la forma.
        // Es el unico test del modulo que no puede afirmar un valor concreto.
        val saludo = Greeting(currentPlatform()).greet()
 
        assertTrue(saludo.startsWith("Hola desde "), "saludo inesperado: $saludo")
        assertTrue(saludo.length > "Hola desde ".length, "falta el nombre de la plataforma")
    }
}

import com.sebastiannarvaez.pokedex.currentPlatform   // import nuevo, junto al de Greeting
 
// en MainActivity.kt, donde antes decía Greeting().greet():
Saludo(texto = Greeting(currentPlatform()).greet())    // la app de Android es quien pide la Platform, una sola vez

import SwiftUI
import Shared
 
struct ContentView: View {
    // El saludo viene del módulo compartido.
    private let saludo = Greeting(platform: PlatformKt.currentPlatform()).greet()
 
    var body: some View {
        Text(saludo)
            .font(.title2)
            .padding()
    }
}

ContentView.swift:6:45: error: cannot find 'PlatformKt' in scope

import SwiftUI
import Shared
 
struct ContentView: View {
    // El saludo viene del modulo compartido: es la prueba de que iOS esta
    // consumiendo el mismo Kotlin que Android.
    //
    // `Platform_iosKt` chirria, y con razon: el nombre sale del fichero donde
    // vive el `actual`, que es Platform.ios.kt. Se arregla en la leccion de
    // funciones que cruzan a Swift; de momento se deja a la vista.
    private let saludo = Greeting(platform: Platform_iosKt.currentPlatform()).greet()
 
    var body: some View {
        Text(saludo)
            .font(.title2)
            .padding()
    }
}
 
#Preview {
    ContentView()
}