Lenguaje de definición de la interfaz de Android (AIDL)

El lenguaje de definición de la interfaz de Android (AIDL) es similar a otros IDL: te permite definir la interfaz de programación que acuerdan el cliente y el servicio para comunicarse entre sí con la comunicación entre procesos (IPC).

En Android, un proceso no puede acceder normalmente a la memoria de otro proceso. Para comunicarse, deben descomponer sus objetos en primitivas que el sistema operativo pueda comprender y ordenar los objetos a través de ese límite por ti. El código para realizar esa clasificación es tedioso de escribir, por lo que Android lo hace por ti con AIDL.

Nota: AIDL solo es necesario si permites que clientes de diferentes aplicaciones accedan a tu servicio para IPC y quieres controlar varios subprocesos en tu servicio. Si no necesitas realizar IPC simultáneas en diferentes aplicaciones, crea tu interfaz implementando un Binder. Si quieres realizar una IPC, pero no necesitas controlar varios subprocesos, implementa tu interfaz con un Messenger. De cualquier manera, asegúrate de comprender los servicios vinculados antes de implementar un AIDL.

Antes de comenzar a diseñar tu interfaz de AIDL, ten en cuenta que las llamadas a una interfaz de AIDL son llamadas a funciones directas. No hagas suposiciones sobre el subproceso en el que se produce la llamada. Lo que sucede es diferente según si la llamada proviene de un subproceso en el proceso local o en un proceso remoto:

  • Las llamadas realizadas desde el proceso local se ejecutan en el mismo subproceso que realiza la llamada. Si este es tu subproceso de IU principal, ese subproceso continuará ejecutándose en la interfaz de AIDL. Si es otro subproceso, ese es el que ejecuta tu código en el servicio. Por lo tanto, si solo los subprocesos locales acceden al servicio, puedes controlar por completo qué subprocesos se ejecutan en él. Sin embargo, si ese es el caso, no uses AIDL en absoluto; en su lugar, crea la interfaz implementando un Binder.
  • Las llamadas de un proceso remoto se envían desde un grupo de subprocesos que la plataforma mantiene dentro de tu propio proceso. Prepárate para recibir llamadas entrantes de subprocesos desconocidos, con varias llamadas que se realizan al mismo tiempo. En otras palabras, una implementación de una interfaz de AIDL debe tener protección de subprocesos completa. Las llamadas que se realizan desde un subproceso en el mismo objeto remoto llegan en orden al extremo del receptor.
  • La palabra clave oneway modifica el comportamiento de las llamadas remotas. Cuando se usa, una llamada remota no se bloquea. Envía los datos de la transacción y devuelve el resultado de inmediato. La implementación de la interfaz, con el tiempo, recibe esto como una llamada normal del grupo de subprocesos Binder como una llamada remota normal. Si se usa oneway con una llamada local, no hay impacto y la llamada sigue siendo síncrona.

Cómo definir una interfaz de AIDL

Define tu interfaz AIDL en un archivo .aidl con la sintaxis del lenguaje de programación Java y, luego, guárdala en el código fuente, en el directorio src/, tanto de la aplicación que aloja el servicio como de cualquier otra aplicación que se vincule al servicio.

Cuando compilas cada aplicación que contiene el archivo .aidl, las herramientas del SDK de Android generan una interfaz IBinder basada en el archivo .aidl y la guardan en el directorio gen/ del proyecto. El servicio debe implementar la interfaz IBinder según corresponda. Luego, las aplicaciones cliente pueden vincularse al servicio y llamar a métodos desde la IBinder para realizar la IPC.

Para crear un servicio vinculado con AIDL, sigue estos pasos, que se describen en las siguientes secciones:

  1. Crea el archivo .aidl

    Este archivo define la interfaz de programación con firmas de métodos.

  2. Implementa la interfaz

    Las herramientas del SDK de Android generan una interfaz en el lenguaje de programación Java según tu archivo .aidl. Esta interfaz tiene una clase abstracta interna llamada Stub que extiende Binder y, además, implementa métodos de tu interfaz AIDL. Debes extender la clase Stub y, luego, implementar los métodos.

  3. Expón la interfaz a los clientes

    Implementa un Service y anula onBind() para devolver tu implementación de la clase Stub.

Precaución: Cualquier cambio que realices en tu interfaz de AIDL después de tu primera versión debe seguir siendo retrocompatible para evitar que se dañen otras aplicaciones que usen tu servicio. Es decir, debido a que tu archivo .aidl debe copiarse en otras aplicaciones para que puedan acceder a la interfaz de tu servicio, debes mantener la compatibilidad con la interfaz original.

Crea el archivo .aidl

AIDL usa una sintaxis simple que te permite declarar una interfaz con uno o más métodos que pueden tomar parámetros y devolver valores. Los parámetros y los valores que se muestran pueden ser de cualquier tipo, incluso otras interfaces generadas por AIDL.

Debes construir el archivo .aidl con el lenguaje de programación Java. Cada archivo .aidl debe definir una sola interfaz y requiere solo la declaración de la interfaz y las firmas de los métodos.

De forma predeterminada, AIDL admite los siguientes tipos de datos:

  • Todos los tipos primitivos, con la excepción de short, en el lenguaje de programación Java (como int, long,char, boolean, etcétera)
  • Arrays de cualquier tipo, como int[] o MyParcelable[]
  • String
  • CharSequence
  • List

    Todos los elementos de List deben ser uno de los tipos de datos admitidos en esta lista o una de las otras interfaces o parcelables generados por AIDL que declares. De manera opcional, se puede usar un List como una clase de tipo parametrizado, como List<String>. La clase concreta real que recibe el otro lado siempre es un ArrayList, aunque el método se genera para usar la interfaz List.

  • Map

    Todos los elementos de Map deben ser uno de los tipos de datos admitidos en esta lista o una de las otras interfaces o parcelables generados por AIDL que declares. No se admiten los mapas de tipos parametrizados, como los que tienen el formato Map<String,Integer>. La clase concreta real que recibe el otro lado siempre es un HashMap, aunque el método se genera para usar la interfaz Map. Considera usar un Bundle como alternativa a Map.

Debes incluir una sentencia import para cada tipo adicional que no se haya mencionado antes, incluso si se definen en el mismo paquete que tu interfaz.

Cuando definas la interfaz de servicio, ten en cuenta lo siguiente:

  • Los métodos pueden tomar cero o más parámetros, y pueden devolver un valor o un valor nulo.
  • Todos los parámetros no primitivos requieren una etiqueta direccional que indique hacia dónde van los datos: in, out o inout (consulta el ejemplo que aparece a continuación).

    Las primitivas, String, IBinder y las interfaces generadas por AIDL son in de forma predeterminada y no pueden ser de otra manera.

    Precaución: Limita la dirección a lo que realmente se necesita, ya que la serialización de parámetros es costosa.

  • Todos los comentarios de código incluidos en el archivo .aidl se incluyen en la interfaz IBinder generada, excepto los comentarios antes de las declaraciones de importación y de paquete.
  • Las constantes de cadena y de número entero se pueden definir en la interfaz de AIDL, como const int VERSION = 1;.
  • Las llamadas de método se envían mediante un código transact(), que, por lo general, se basa en un índice de método en la interfaz. Como esto dificulta el control de versiones, puedes asignar manualmente el código de transacción a un método: void method() = 10;.
  • Los argumentos anulables y los tipos de datos que se devuelven deben anotarse con @nullable.

A continuación, se muestra un archivo .aidl de ejemplo:

// IRemoteService.aidl
package com.example.android;

// Declare any non-default types here with import statements.

/** Example service interface. */
interface IRemoteService {
    /** Request the process ID of this service. */
    int getPid();

    /** Demonstrates some basic types that you can use as parameters
     * and return values in AIDL.
     */
    void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat,
            double aDouble, String aString);
}

Guarda el archivo .aidl en el directorio src/ de tu proyecto. Cuando compilas tu aplicación, las herramientas del SDK generan el archivo de interfaz IBinder en el directorio gen/ de tu proyecto. El nombre del archivo generado coincide con el del archivo .aidl, pero con una extensión .java. Por ejemplo, IRemoteService.aidl da como resultado IRemoteService.java.

Si usas Android Studio, la compilación incremental genera la clase de vinculación casi de inmediato. Si no usas Android Studio, la herramienta de Gradle generará la clase de vinculación la próxima vez que compiles tu aplicación. Compila tu proyecto con gradle assembleDebug o gradle assembleRelease en cuanto termines de escribir el archivo .aidl para que tu código pueda vincularse con la clase generada.

Cómo implementar la interfaz

Cuando compilas tu aplicación, las herramientas del SDK de Android generan un archivo de interfaz .java con el nombre de tu archivo .aidl. La interfaz generada incluye una subclase llamada Stub, que es una implementación abstracta de su interfaz superior, como YourInterface.Stub, y declara todos los métodos del archivo .aidl.

Nota: Stub también define algunos métodos auxiliares, en especial asInterface(), que toma un IBinder, por lo general, el que se pasa al método de devolución de llamada onServiceConnected() de un cliente, y devuelve una instancia de la interfaz de stub. Para obtener más detalles sobre cómo realizar esta conversión, consulta la sección Cómo llamar a un método de IPC.

Para implementar la interfaz generada a partir del .aidl, extiende la interfaz Binder generada, como YourInterface.Stub, y, luego, implementa los métodos heredados del archivo .aidl.

A continuación, se muestra un ejemplo de implementación de una interfaz llamada IRemoteService, definida por el ejemplo de IRemoteService.aidl anterior, con una instancia anónima:

private val binder = object : IRemoteService.Stub() {

    override fun getPid(): Int =
        Process.myPid()

    override fun basicTypes(
        anInt: Int,
        aLong: Long,
        aBoolean: Boolean,
        aFloat: Float,
        aDouble: Double,
        aString: String
    ) {
        // Does nothing.
    }
}

Ahora, binder es una instancia de la clase Stub (un Binder), que define la interfaz de IPC para el servicio. En el siguiente paso, esta instancia se expone a los clientes para que puedan interactuar con el servicio.

Ten en cuenta algunas reglas cuando implementes tu interfaz de AIDL:

  • No se garantiza que las llamadas entrantes se ejecuten en el subproceso principal, por lo que debes pensar en el uso de varios subprocesos desde el principio y compilar correctamente tu servicio para que sea seguro para subprocesos.
  • De forma predeterminada, las llamadas de IPC son síncronas. Si sabes que el servicio tarda más de unos milisegundos en completar una solicitud, no lo llames desde el subproceso principal de la actividad. Esto podría bloquear la aplicación y hacer que Android muestre un diálogo de "La aplicación no responde". Llámalo desde un subproceso separado en el cliente.
  • Solo los tipos de excepciones que se indican en la documentación de referencia de Parcel.writeException() se envían de vuelta al emisor.

Expón la interfaz a los clientes

Una vez que hayas implementado la interfaz para tu servicio, debes exponerla a los clientes para que puedan vincularse a ella. Para exponer la interfaz de tu servicio, extiende Service e implementa onBind() para que se devuelva una instancia de tu clase que implemente el Stub generado, como se explicó en la sección anterior. Este es un ejemplo de servicio que expone la interfaz de ejemplo IRemoteService a los clientes.

class RemoteService : Service() {

    override fun onCreate() {
        super.onCreate()
    }

    override fun onBind(intent: Intent): IBinder {
        // Return the interface.
        return binder
    }

    private val binder = object : IRemoteService.Stub() {
        override fun getPid(): Int {
            return Process.myPid()
        }

        override fun basicTypes(
            anInt: Int,
            aLong: Long,
            aBoolean: Boolean,
            aFloat: Float,
            aDouble: Double,
            aString: String
        ) {
            // Does nothing.
        }
    }
}

Ahora, cuando un cliente, como una actividad, llama a bindService() para conectarse a este servicio, la devolución de llamada onServiceConnected() del cliente recibe la instancia de binder que devuelve el método onBind() del servicio.

El cliente también debe tener acceso a la clase de interfaz. Por lo tanto, si el cliente y el servicio se encuentran en aplicaciones separadas, la aplicación del cliente debe tener una copia del archivo .aidl en su directorio src/, que genera la interfaz android.os.Binder, lo que proporciona al cliente acceso a los métodos AIDL.

Cuando el cliente recibe el IBinder en la devolución de llamada onServiceConnected(), debe llamar a YourServiceInterface.Stub.asInterface(service) para convertir el parámetro devuelto al tipo YourServiceInterface:

var iRemoteService: IRemoteService? = null

val mConnection = object : ServiceConnection {

    // Called when the connection with the service is established.
    override fun onServiceConnected(className: ComponentName, service: IBinder) {
        // Following the preceding example for an AIDL interface,
        // this gets an instance of the IRemoteInterface, which we can use to call on the service.
        iRemoteService = IRemoteService.Stub.asInterface(service)
    }

    // Called when the connection with the service disconnects unexpectedly.
    override fun onServiceDisconnected(className: ComponentName) {
        Log.e(TAG, "Service has unexpectedly disconnected")
        iRemoteService = null
    }
}

Para obtener más código de muestra, consulta la clase RemoteService.java en ApiDemos.

Cómo pasar objetos a través de IPC

En Android 10 (nivel de API 29 o posterior), puedes definir objetos Parcelable directamente en AIDL. Aquí también se admiten los tipos que se admiten como argumentos de interfaz de AIDL y otros objetos parcelables. Esto evita el trabajo adicional de escribir manualmente el código de ordenamiento y una clase personalizada. Sin embargo, esto también crea un struct vacío. Si se desean descriptores de acceso personalizados o alguna otra funcionalidad, implementa Parcelable en su lugar.

package android.graphics;

// Declare Rect so AIDL can find it and knows that it implements
// the parcelable protocol.
parcelable Rect {
    int left;
    int top;
    int right;
    int bottom;
}

La muestra de código anterior genera automáticamente una clase de Java con los campos de número entero left, top, right y bottom. Todo el código de ordenamiento relevante se implementa automáticamente, y el objeto se puede usar directamente sin tener que agregar ninguna implementación.

También puedes enviar una clase personalizada de un proceso a otro a través de una interfaz de IPC. Sin embargo, asegúrate de que el código de tu clase esté disponible para el otro lado del canal de IPC y de que tu clase admita la interfaz Parcelable. La compatibilidad con Parcelable es importante porque permite que el sistema Android descomponga objetos en primitivas que se pueden ordenar entre procesos.

Para crear una clase personalizada que admita Parcelable, haz lo siguiente:

  1. Haz que tu clase implemente la interfaz Parcelable.
  2. Implementa writeToParcel, que toma el estado actual del objeto y lo escribe en un Parcel.
  3. Agrega un campo estático llamado CREATOR a tu clase, que es un objeto que implementa la interfaz Parcelable.Creator.
  4. Por último, crea un archivo .aidl que declare tu clase parcelable, como se muestra en el siguiente archivo Rect.aidl.

    Si usas un proceso de compilación personalizado, no agregues el archivo .aidl a tu compilación. Al igual que un archivo de encabezado en el lenguaje C, este archivo .aidl no se compila.

AIDL usa estos métodos y campos en el código que genera para ordenar y desordenar tus objetos.

Por ejemplo, aquí se muestra un archivo Rect.aidl para crear una clase Rect que se puede empaquetar:

package android.graphics;

// Declare Rect so AIDL can find it and knows that it implements
// the parcelable protocol.
parcelable Rect;

A continuación, se muestra un ejemplo de cómo la clase Rect implementa el protocolo Parcelable.

// import android.os.Parcel
// import android.os.Parcelable

class Rect() : Parcelable {
    var left: Int = 0
    var top: Int = 0
    var right: Int = 0
    var bottom: Int = 0

    companion object CREATOR : Parcelable.Creator<Rect> {
        override fun createFromParcel(parcel: Parcel): Rect {
            return Rect(parcel)
        }

        override fun newArray(size: Int): Array<Rect?> {
            return Array(size) { null }
        }
    }

    private constructor(inParcel: Parcel) : this() {
        readFromParcel(inParcel)
    }

    override fun writeToParcel(outParcel: Parcel, flags: Int) {
        outParcel.writeInt(left)
        outParcel.writeInt(top)
        outParcel.writeInt(right)
        outParcel.writeInt(bottom)
    }

    private fun readFromParcel(inParcel: Parcel) {
        left = inParcel.readInt()
        top = inParcel.readInt()
        right = inParcel.readInt()
        bottom = inParcel.readInt()
    }

    override fun describeContents(): Int {
        return 0
    }
}

La serialización en la clase Rect es sencilla. Echa un vistazo a los otros métodos en Parcel para ver los otros tipos de valores que puedes escribir en un Parcel.

Advertencia: Recuerda las implicaciones de seguridad que tiene recibir datos de otros procesos. En este caso, el Rect lee cuatro números del Parcel, pero depende de ti asegurarte de que estén dentro del rango aceptable de valores para lo que el emisor intente hacer. Para obtener más información sobre cómo proteger tu aplicación contra software malicioso, consulta Sugerencias de seguridad.

Métodos con argumentos de Bundle que contienen Parcelables

Si un método acepta un objeto Bundle que se espera que contenga parcelables, asegúrate de configurar el cargador de clases de Bundle llamando a Bundle.setClassLoader(ClassLoader) antes de intentar leer desde Bundle. De lo contrario, se producirá un error ClassNotFoundException, aunque el parcelable esté definido correctamente en tu aplicación.

Por ejemplo, considera el siguiente archivo .aidl de muestra:

// IRectInsideBundle.aidl
package com.example.android;

/** Example service interface. */
interface IRectInsideBundle {
    /** Rect parcelable is stored in the bundle with key "rect". */
    void saveRect(in Bundle bundle);
}
Como se muestra en la siguiente implementación, ClassLoader se establece de forma explícita en Bundle antes de leer Rect:
private val binder = object : IRectInsideBundle.Stub() {
    override fun saveRect(bundle: Bundle) {
        bundle.classLoader = classLoader
        val rect = BundleCompat.getParcelable(bundle, "rect", Rect::class.java)
        process(rect) // Do more with the parcelable.
    }
}

Llama a un método de IPC

Para llamar a una interfaz remota definida con AIDL, sigue estos pasos en tu clase de llamada:

  1. Incluye el archivo .aidl en el directorio src/ del proyecto.
  2. Declara una instancia de la interfaz IBinder, que se genera en función del AIDL.
  3. Implementar ServiceConnection
  4. Llama a Context.bindService() y pasa tu implementación de ServiceConnection.
  5. En tu implementación de onServiceConnected(), recibes una instancia de IBinder, llamada service. Llama a YourInterfaceName.Stub.asInterface((IBinder)service) para convertir el parámetro que se muestra en el tipo YourInterface.
  6. Llama a los métodos que definiste en tu interfaz. Siempre intercepta las excepciones DeadObjectException, que se arrojan cuando se interrumpe la conexión. Además, intercepta las excepciones SecurityException, que se arrojan cuando los dos procesos involucrados en la llamada de método de IPC tienen definiciones de AIDL en conflicto.
  7. Para desconectarte, llama a Context.unbindService() con la instancia de tu interfaz.

Ten en cuenta estos puntos cuando llames a un servicio de IPC:

  • Los objetos se cuentan como referencia entre procesos.
  • Puedes enviar objetos anónimos como argumentos de método.

Para obtener más información sobre cómo vincular un servicio, consulta la descripción general de los servicios vinculados.

A continuación, se muestra un código de muestra que llama a un servicio creado con AIDL, tomado del ejemplo de servicio remoto del proyecto ApiDemos.

private const val BUMP_MSG = 1

class Binding : Activity() {

    /** The primary interface you call on the service.  */
    private var mService: IRemoteService? = null

    /** Another interface you use on the service.  */
    internal var secondaryService: ISecondary? = null

    private lateinit var killButton: Button
    private lateinit var callbackText: TextView
    private lateinit var handler: InternalHandler

    private var isBound: Boolean = false

    /**
     * Class for interacting with the main interface of the service.
     */
    private val mConnection = object : ServiceConnection {

        override fun onServiceConnected(className: ComponentName, service: IBinder) {
            // This is called when the connection with the service is
            // established, giving us the service object we can use to
            // interact with the service.  We are communicating with our
            // service through an IDL interface, so get a client-side
            // representation of that from the raw service object.
            mService = IRemoteService.Stub.asInterface(service)
            killButton.isEnabled = true
            callbackText.text = "Attached."

            // We want to monitor the service for as long as we are
            // connected to it.
            try {
                mService?.registerCallback(mCallback)
            } catch (e: RemoteException) {
                // In this case, the service crashes before we can
                // do anything with it. We can count on soon being
                // disconnected (and then reconnected if it can be restarted)
                // so there is no need to do anything here.
            }

            // As part of the sample, tell the user what happened.
            Toast.makeText(
                    this@Binding,
                    R.string.remote_service_connected,
                    Toast.LENGTH_SHORT
            ).show()
        }

        override fun onServiceDisconnected(className: ComponentName) {
            // This is called when the connection with the service is
            // unexpectedly disconnected&mdash;that is, its process crashed.
            mService = null
            killButton.isEnabled = false
            callbackText.text = "Disconnected."

            // As part of the sample, tell the user what happened.
            Toast.makeText(
                    this@Binding,
                    R.string.remote_service_disconnected,
                    Toast.LENGTH_SHORT
            ).show()
        }
    }

    /**
     * Class for interacting with the secondary interface of the service.
     */
    private val secondaryConnection = object : ServiceConnection {

        override fun onServiceConnected(className: ComponentName, service: IBinder) {
            // Connecting to a secondary interface is the same as any
            // other interface.
            secondaryService = ISecondary.Stub.asInterface(service)
            killButton.isEnabled = true
        }

        override fun onServiceDisconnected(className: ComponentName) {
            secondaryService = null
            killButton.isEnabled = false
        }
    }

    private val mBindListener = View.OnClickListener {
        // Establish a couple connections with the service, binding
        // by interface names. This lets other applications be
        // installed that replace the remote service by implementing
        // the same interface.
        val intent = Intent(this@Binding, RemoteService::class.java)
        intent.action = IRemoteService::class.java.name
        bindService(intent, mConnection, Context.BIND_AUTO_CREATE)
        intent.action = ISecondary::class.java.name
        bindService(intent, secondaryConnection, Context.BIND_AUTO_CREATE)
        isBound = true
        callbackText.text = "Binding."
    }

    private val unbindListener = View.OnClickListener {
        if (isBound) {
            // If we have received the service, and hence registered with
            // it, then now is the time to unregister.
            try {
                mService?.unregisterCallback(mCallback)
            } catch (e: RemoteException) {
                // There is nothing special we need to do if the service
                // crashes.
            }

            // Detach our existing connection.
            unbindService(mConnection)
            unbindService(secondaryConnection)
            killButton.isEnabled = false
            isBound = false
            callbackText.text = "Unbinding."
        }
    }

    private val killListener = View.OnClickListener {
        // To kill the process hosting the service, we need to know its
        // PID.  Conveniently, the service has a call that returns
        // that information.
        try {
            secondaryService?.pid?.also { pid ->
                // Note that, though this API lets us request to
                // kill any process based on its PID, the kernel
                // still imposes standard restrictions on which PIDs you
                // can actually kill. Typically this means only
                // the process running your application and any additional
                // processes created by that app, as shown here. Packages
                // sharing a common UID are also able to kill each
                // other's processes.
                Process.killProcess(pid)
                callbackText.text = "Killed service process."
            }
        } catch (ex: RemoteException) {
            // Recover gracefully from the process hosting the
            // server dying.
            // For purposes of this sample, put up a notification.
            Toast.makeText(this@Binding, R.string.remote_call_failed, Toast.LENGTH_SHORT).show()
        }
    }

    // ----------------------------------------------------------------------
    // Code showing how to deal with callbacks.
    // ----------------------------------------------------------------------

    /**
     * This implementation is used to receive callbacks from the remote
     * service.
     */
    private val mCallback = object : IRemoteServiceCallback.Stub() {
        /**
         * This is called by the remote service regularly to tell us about
         * new values.  Note that IPC calls are dispatched through a thread
         * pool running in each process, so the code executing here is
         * NOT running in our main thread like most other things. So,
         * to update the UI, we need to use a Handler to hop over there.
         */
        override fun valueChanged(value: Int) {
            handler.sendMessage(handler.obtainMessage(BUMP_MSG, value, 0))
        }
    }

    /**
     * Standard initialization of this activity.  Set up the UI, then wait
     * for the user to interact with it before doing anything.
     */
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        setContentView(R.layout.remote_service_binding)

        // Watch for button taps.
        var button: Button = findViewById(R.id.bind)
        button.setOnClickListener(mBindListener)
        button = findViewById(R.id.unbind)
        button.setOnClickListener(unbindListener)
        killButton = findViewById(R.id.kill)
        killButton.setOnClickListener(killListener)
        killButton.isEnabled = false

        callbackText = findViewById(R.id.callback)
        callbackText.text = "Not attached."
        handler = InternalHandler(callbackText)
    }

    private class InternalHandler(
            textView: TextView,
            private val weakTextView: WeakReference<TextView> = WeakReference(textView)
    ) : Handler() {
        override fun handleMessage(msg: Message) {
            when (msg.what) {
                BUMP_MSG -> weakTextView.get()?.text = "Received from service: ${msg.arg1}"
                else -> super.handleMessage(msg)
            }
        }
    }
}