ADict on every platform

1. Selektywność KMP1. KMP module selection

Do commonMain dodaj tylko potrzebne logiczne moduły. Gradle sam wybierze wariant Android, JVM, iOS lub Wasm. Nie wpisuj ręcznie współrzędnych z sufiksem platformy.

Add only the required logical modules to commonMain. Gradle selects Android, JVM, iOS or Wasm variants automatically. Never declare platform-suffixed coordinates directly.

kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("rip.nerd.adictlibrary:adict-core:3.0.0")
            implementation("rip.nerd.adictlibrary:adict-foundation:3.0.0")
            implementation("rip.nerd.adictlibrary:adict-billing:3.0.0")
            implementation("rip.nerd.adictlibrary:adict-ads-core:3.0.0")
            implementation("rip.nerd.adictlibrary:adict-ads-homeads:3.0.0")
        }
        androidMain.dependencies {
            // Only for ADict.init(), manifest discovery and legacy Android UI.
            implementation("rip.nerd.adictlibrary:adict-runtime:3.0.0")
        }
    }
}

2. Kod wspólny i reklamy bez SDK2. Shared code and SDK-free ads

class AppFeatures(services: ADictPlatformServices) : AutoCloseable {
    private val foundation = ADictFoundation(services)
    val billing = foundation.services?.billing?.let(::ADictBilling)

    override fun close() = foundation.close()
}

val houseAds = HouseAdsGateway(
    campaigns = listOf(
        HouseAdCampaign(
            id = "upgrade",
            placements = setOf("home"),
            formats = setOf(AdFormat.BANNER),
            payload = "app://premium"
        )
    ),
    presenter = { ad -> showHouseCreative(ad.payload) }
)
val ads = ADictAdsEngine(listOf(houseAds, customNetworkGateway))

customNetworkGateway implementuje publiczny AdGateway. Bez żadnego gatewaya aplikacja ukrywa placement; biblioteka nie raportuje fikcyjnego wyświetlenia.

customNetworkGateway implements the public AdGateway. With no gateway, the application hides the placement; the library never reports a fake impression.

3. Android

val playBilling = AndroidPlayBillingGateway(applicationContext) { foregroundActivity }
val services = ProviderADictServices(
    platform = ADictPlatform.ANDROID,
    billing = playBilling,
    secureStorage = appEncryptedStorage,
    biometrics = appBiometricGateway,
    notifications = appNotificationGateway
)

foregroundActivity zwraca bieżącą Activity lub null. Dowód zakupu Google Play musi trafić do zaufanego backendu przed trwałym nadaniem uprawnienia. Dla starszej fasady użyj ADictPrivacy.update(...), a potem ADict.init(application, BuildConfig.DEBUG); manifest discovery uruchomi tylko zainstalowane moduły.

foregroundActivity returns the current Activity or null. Send Google Play purchase evidence to a trusted backend before granting a durable entitlement. For the legacy facade, call ADictPrivacy.update(...) and then ADict.init(application, BuildConfig.DEBUG); manifest discovery starts installed modules only.

4. iOS / Apple

val native = AppleADictServices(
    AppleADictConfiguration(
        keychainService = "rip.nerd.app",
        billingEnabled = true,
        trackingConsentEnabled = true,
        notificationsEnabled = true
    )
)
val services = OverlayADictServices(
    overrides = ProviderADictServices(
        platform = ADictPlatform.APPLE,
        billing = appStoreBillingOverride,
        sharing = appSharePresenter
    ),
    defaults = native
)

AppleADictServices korzysta ze StoreKit, Keychain, LocalAuthentication, AVSpeechSynthesizer, UIKit, StoreKit Review i UserNotifications. Możesz też użyć pojedynczych fabryk: appleBillingGateway(), appleSecurity(...), appleTextToSpeech() i appleEngagement(...). Pominięty override zachowuje implementację natywną.

AppleADictServices uses StoreKit, Keychain, LocalAuthentication, AVSpeechSynthesizer, UIKit, StoreKit Review and UserNotifications. Individual factories are also available: appleBillingGateway(), appleSecurity(...), appleTextToSpeech() and appleEngagement(...). An omitted override keeps the native implementation.

5. JVM / Desktop

val billing = HostedCheckoutBillingGateway(
    products = catalog,
    checkout = CheckoutLauncher { productId ->
        Desktop.getDesktop().browse(URI("https://pay.example/checkout?product=$productId"))
        true
    },
    entitlements = EntitlementSource { api.loadVerifiedProductIds() }
)
val services = ProviderADictServices(ADictPlatform.JVM, billing = billing)

Otwarcie checkoutu zwraca PurchaseResult.Pending. Dopiero backend zasilany webhookiem operatora potwierdza dostęp przez EntitlementSource.

Opening checkout returns PurchaseResult.Pending. Only the provider-webhook-backed server confirms access through EntitlementSource.

6. Web / Wasm

val webBilling = HostedCheckoutBillingGateway(
    products = catalog,
    checkout = CheckoutLauncher { productId -> openCheckoutWindow(productId) },
    entitlements = EntitlementSource { backend.verifiedEntitlements() }
)
val webServices = ProviderADictServices(
    platform = ADictPlatform.WEB,
    billing = webBilling,
    clipboard = browserClipboardGateway,
    sharing = browserShareGateway
)

CheckoutLauncher może otworzyć PayPal, Stripe lub inny checkout wybrany przez aplikację. localStorage nie jest bezpiecznym magazynem. Odmowa przeglądarki wyłącza capability zamiast zwracać sukces.

CheckoutLauncher may open PayPal, Stripe or another application-selected checkout. localStorage is not secure storage. Browser denial disables the capability instead of returning success.

7. Własny dostawca i bezpieczny fallback7. Custom provider and safe fallback

class PartnerAdsGateway(private val sdk: PartnerSdk) : AdGateway {
    override val provider = AdProvider(id = "partner", priority = 100)
    override suspend fun load(request: AdRequest): AdLoadResult = sdk.load(request)
    override suspend fun show(ad: LoadedAd): Boolean = sdk.show(ad)
}

val services = ProviderADictServices(
    platform = currentPlatform,
    billing = appBillingGateway,
    consent = appConsentGateway,
    secureStorage = appSecureStorage,
    textToSpeech = appSpeechEngine
)

Ten sam wzorzec obejmuje BillingGateway, SessionSink, DiagnosticProbe, TextToSpeechGateway i LocalNotificationGateway. Brak odpowiednika oznacza null i wyłączoną funkcję UI, nigdy atrapę sukcesu.

The same pattern covers BillingGateway, SessionSink, DiagnosticProbe, TextToSpeechGateway and LocalNotificationGateway. No equivalent means null and a disabled UI capability, never a fake success.

8. Macierz demonstracyjna8. Demo matrix

Windows może kompilować targety iOS, lecz testy symulatora uruchamia runner macOS.

Windows can compile iOS targets, but simulator tests run on a macOS runner.