Getting Started

In this guide we will walk you through setting up your Briefcase environment for development and testing. We will assume that you have a working Python install, and an existing project.

Install Briefcase

The first step is to install Briefcase. If you’re using a virtual environment for your project, don’t forget to activate it.

$ mkdir tutorial
$ cd tutorial
$ python3 -m venv venv
$ . venv/bin/activate
$ pip install briefcase

Note

Briefcase (and the whole BeeWare toolchain) requires Python 3. Support for different Python 3 minor versions varies depending on the platform you’re targetting; Python 3.5 will give you the best results.

Install platform dependencies

Next, you’ll need to make sure you’ve got the platform-specific dependencies for the platforms you’re going to target.

Windows

If you’re using Windows 10, you may need to enable the .NET 3.5 framework on your machine. Select “Programs and Features” from the Start menu, then “Turn Windows features on or off”, and ensure ”.NET Framework 3.5 (Includes .NET 2.0 and 3.0)” is enabled.

Linux

You’ll need install GTK+ 3.10 or later. This is the version that ships starting with Ubuntu 14.04 and Fedora 20. You also need to install the Python 3 bindings to GTK+. If you want to use the WebView widget, you’ll also need to have WebKit, plus the GI bindings to WebKit installed. This means you’ll need to install the following:

  • Ubuntu 14.04 apt-get install python3-gi gir1.2-webkit2-3.0
  • Ubuntu 16.04 apt-get install python3-gi gir1.2-webkit2-4.0 or apt-get install python3-gi gir1.2-webkit2-3.0
  • Fedora 20+ ???
  • Debian ???

iOS

  • Install XCode from the App store.

Android

  • Install Android Studio. When you start Android Studio for the first time, you’ll be provided a wizard to configure your installation; select a “standard” installation.

  • Put the sdk/tools, sdk/platform-tools and sdk/tools/bin directories in your path. - On macOS: ~/Library/Android/sdk/tools, ~/Library/Android/sdk/platform-tools and ~/Library/Android/sdk/tools/bin

  • Set the ANDROID_SDK_HOME directory - On macOS: ~/Library/Android/sdk

  • Update the SDKs:

    $ sdkmanager --update
    
  • Create a virtual device image, following these instructions.

  • Install Gradle.

  • Start the emulator:

    $ emulator @Nexus_5X_API_22
    

Django

  • Install an LTS version of Node (6.9.x)
  • Install NPM 4.x or higher

Next Steps

You now have a working Briefcase environment, so you can start the first tutorial.