Skip to content

Overview

A solution for running and configuring a local HTTP server to mimic REST API endpoints used by your iOS, Android or KMM application.

Supported Environments

  • Native iOS apps (written in Swift)
  • Native Android apps
  • Kotlin Multiplatform Apps (Android & iOS targets only).

Quick Start

Important

Mockzilla does not support HTTPS, all traffic is cleartext HTTP.

Warning

Mockzilla is not a production tool. It is for development and testing only. It should never be deployed to production. Running a server on device may introduce un-foreseen security issues.

Installation

Add the gradle dependency:

implementation("com.apadmi:mockzilla:1.0.0-alpha1")

Add the SPM dependency in XCode:

  1. File > Swift Packages > Add Package Dependency
  2. Add https://github.com/Apadmi-Engineering/SwiftMockzilla.git

Note

Note: This is not for KMM projects (for those, the gradle dependecy should be added to shared source set). This SPM dependency is for purely native iOS apps only.

Starting The Server

Mockzilla is entirely driven by a config object which is used to start the server.

(1): Create the config:

val config = MockzillaConfig.Builder()
    .addEndpoint(
        EndpointConfiguration
            .Builder("Hello World")
            .setDefaultHandler {
                MockzillaHttpResponse(body = "Hello World")
            })
    .build()

let config = MockzillaConfig.Builder()
    .addEndpoint(endpoint: EndpointConfiguration.Builder(id: "Hello world")
        .setDefaultHandler { _ in
            MockzillaHttpResponse(body: "Hello world")
        }.build()
    ).build()

See here for more information on configuring your endpoints. (Including compile-time safety!)

(2): Just start the server!

Note

For KMM apps, even though all the configuration can be defined in Kotlin. The server should still be started directly from within native code on both platforms. See the KMM demo for an example.

class RootApplication : Application() {

    override fun onCreate() {
        super.onCreate()

        val config = MockzillaConfig.Builder()....
        startMockzilla(config, this)
    }
}

import UIKit
import SwiftMockzilla
import mockzilla

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_: UIApplication,
                     didFinishLaunchingWithOptions _: [UIApplication.LaunchOptionsKey: Any]?) -> Bool
    {
        let config = MockillaConfig.Builder()...
        startMockzilla(config: config)

        return true
    }
}

(3): Call the server from your client code

Mockzilla listens for calls to http://localhost:8080/local-mock (this should be your base url).

To configure the port see here.

Recommendation

Since Mockzilla shouldn't be included in production binaries, we recommend creating a new product flavour specifically for the mock and only including this dependency for this variant.

For KMM projects this will require creating a new KMM module in your project specifically for the mock.

Tips

Ensure your development machine and test device are on the same wifi network. You can replace localhost with your device's IP addresss and try calling these endpoints from Postman (or a similar REST client.)

alt text

Back to top