[Guide] Run clickable on macOS
I wanted to use my MacBook Air to develop Ubuntu Touch apps. After a lot of trial and error I've got clickable working. So here's is a guide on how to set up clickable for macOS.
First off, you'll need to install Homebrew with this command:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
After installing Homebrew you'll need to install
dockerwith the following commands (open the macOS terminal):
brew install python3
brew cask install android-platform-tools
brew cask install docker
After installing Docker, open the Docker application (via Launchpad or by pressing Command + Space and searching for it with spotlight). Click OK in the Docker needs privileged access dialog and enter your user password. A whale icon will appear in the status menu and the symbolic links for
docker-machineare created in
/usr/local/bin. Confirm that docker is running, by clicking the icon in the status menu. If it says Docker Desktop is running you're ready to test out clickable!
Open the macOS terminal app and
cdinto the directory you want to store and build your app. Run the command
clickable initto create a new app project.
cdinto your app project folder. Run
clickableto build your app and push it to your Ubuntu Touch device through adb!
clickable desktopis not working. I've installed XQuartz but I get the following error:
Successfully built package in './test.sanderklootwijk_1.0.0_all.click'. non-network local connections being added to access control list Mounting device home to /Users/sander/.clickable/home docker: Error response from daemon: Mounts denied: The paths /dev/snd and /var/lib/dbus and /run/501/pulse and /home/sander/.pulse are not shared from OS X and are not known to Docker. You can configure shared paths from Docker -> Preferences... -> File Sharing. See https://docs.docker.com/docker-for-mac/osxfs/#namespaces for more info. . ERRO error waiting for container: context canceled Command exited with non-zero exit status 125, see above for details. This is most likely not a problem with Clickable.
Atom with the language-qml and atom-build-clickable packages, works great for developing Ubuntu Touch apps on macOS. Get the Atom text editor here and install language-qml and atom-build-clickable (Atom > preferences > install).
For some reason I can't update the post above. But before you're able to run clickable, you'll need to install it of course. I forgot this step in the guide
Install clickable with the following command:
pip3 install git+https://gitlab.com/clickable/clickable.git
Now you'll be able to run clickable!
Great work Sander!
Just curious though, what happens when you configure the folders mentioned in the error message to be shareable to the container in the the docker preferences?
@arubislander I think it has something to do with pulseaudio (which is not installed by default on macOS). You can install it with homebrew:
brew install pulseaudio
I've tried to add the paths to Docker, but I get exactly the same error.