In my last post I introduced you to gomobile and how you can build a go/opengl application for deployment on iOS and Android. Today I will show you how easy it is to create a cross platform library based in go. For the examples in this post I am assuming you have a working go 1.5 environment as defined in my previous post.

Why go?

It’s fairly likely that if you are creating any non-trivial app you are already using libraries to supplement your code. If you are targeting multiple platforms it’s likely that you’ve had to find/write libraries for both platforms, so why not bring it down to 1 library written in go? Potential library use cases I can think of are REST clients, and business logic code.

Personally I find that writing go code is more enjoyable and less verbose than writing Java for Android. I don’t have much exposure to objective-c however.

Show me how

First let’s start with a really simple go program. I’ve written a sudo random number generator seeded with the current second using the default golang libraries.

package random

import (

func SudoRandomNumer() int {
	return rand.Intn(time.Now().Second())

Now I can run gomobile bind to generate an Android Archive (.aar) file, to generate for iOS you must include -target iOS. To include the .aar file in an Android project using Android Studio use the module import wizard (File > New > New Module > Import .JAR or .AAR package), and setting it as a new dependency (File > Project Structure > Dependencies). Alternatively you can generate the Gradle configuration yourself.

Now create a program to use the go library. I’ve created a very simple Android project that displays the random number on create. The main activity using our go code is:

package com.codingvelocity.helloworldgolib;

import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
import android.widget.TextView;
import go.random.Random;
public class HelloActivity extends AppCompatActivity {

    protected void onCreate(Bundle savedInstanceState) {
        TextView view = (TextView) findViewById(;

    //boiler plate code

How does it work?

For Android the gomobile command generates jni bindings and a shared object file (.so) so the two can interact. For iOS gomobile generates a shared archive file (.a) that can be imported in objective c code.


Currently the exported function return types are limited to a small number of types but should be expanded on in the future.

iOS support is still a work in progress, so in reality this isn’t quite ready for prime time.

Further reading