Building for MacOS

This page documents the process of building an Arcade game for MacOS using Briefcase.

Installation

To begin, install and use Briefcase by executing:

  • pip install briefcase

  • mkdir ~/path/to/game/dist

  • cd ~/path/to/game/dist

  • cookiecutter https://github.com/pybee/briefcase-template

    Choose the values that suit you. Most defaults work, except for Select gui_framework, for which you must choose 2 - None.

    You should automatically be in your new dist/ directory.

    Moving forward, replace appname with the first value you supplied to Cookiecutter (the name of your game).

  • Open appname/setup.py, find install_requires, and add arcade and any of your additional requirements, like so:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
setup(
    ...
    install_requires=[
        'arcade',
    ],
    # If you have resources
    include_package_data=True,
    package_data={
        # Replace appname with the name of your complicated
        # Replace the value here with a list of files that contain
        #   your game's resources
        'appname': ['/images/*',],
    },
)
  • Open appname/__main__.py and edit the file to look like this:
1
2
3
4
from appname.app import main

if __name__ == '__main__':
    main()
  • Open appname/app.py and edit the file to look like this:
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
import arcade


def main():
    window = arcade.Window()
    arcade.run()


if __name__ == "__main__":
    main()