protobuild/protobuild.manager

A cross-platform GUI manager for Protobuild modules. Supports branding.

Protobuild.Manager

A cross-platform GUI manager for Protobuild projects. It's goals are:

• Make it easy to create cross-platform projects from templates
• Allow developers using Protobuild to easily change the platform they're working on

Installation

Windows

On Windows, we provide a web installer. You need an internet connection while the installer is running to complete the installation.

Download for Windows

macOS

On macOS, we provide a script to complete the installation. You will need to download and install Mono first:

Download Mono for macOS

After you have installed Mono, open a terminal, and then run:

curl -L https://github.com/Protobuild/Protobuild.Manager/releases/download/latest/ProtobuildMacOSInstall.sh | bash

Linux

On Linux, we provide a script to complete the installation. Depending on your distro, you may need to install dependency packages. Instructions for known distributions are listed below:

Fedora

# Install Mono and GTK# 3 with the following command:
sudo dnf install mono-core gtk-sharp3
# Run the script to install Protobuild Manager:
curl -L https://github.com/Protobuild/Protobuild.Manager/releases/download/latest/ProtobuildLinuxInstall.sh | bash

OpenSUSE

# Install Mono, GTK# 3 and WebKit GTK 3 with the following command:
sudo zypper in mono-core gtk-sharp3 libwebkitgtk-3_0_0
# Run the script to install Protobuild Manager:
curl -L https://github.com/Protobuild/Protobuild.Manager/releases/download/latest/ProtobuildLinuxInstall.sh | bash

Ubuntu

# Make sure you have the universe repository enabled first:
sudo add-apt-repository "deb http://archive.ubuntu.com/ubuntu $(lsb_release -sc) universe"
sudo apt update
# Install Mono, GTK# 3, WebKit GTK 3 and extra libraries with the following command:
sudo apt install mono-runtime gtk-sharp3 libwebkitgtk-3.0-0 libmono-system-web-extensions4.0-cil
# Run the script to install Protobuild Manager:
curl -L https://github.com/Protobuild/Protobuild.Manager/releases/download/latest/ProtobuildLinuxInstall.sh | bash

Other Distros

If you know of the commands required to install dependencies on other Linux distributions, please submit a pull request to update this documentation.

How to Contribute

Please refer to the Protobuild repository for instructions on how to contribute.

License Information

Protobuild Manager is licensed under the MIT license.

Copyright (c) 2015 Various Authors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

Community Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

protobuild.manager's Issues

When a project is no longer on disk, the entry is not removed after "No Solution Found" error

Protobuild Manager should remove an entry from the recent projects list after the user tries to open it and encounters the "No Solution Found" error.

OSX Issues

For reference, these are the OSX issues I was talking about:

When attempting to set up Protobuild Manager on OSX 10.11, I had the following issues:

• wget is not installed by default - Script prompts me to install it with brew.
• brew is not installed by default - We should probably address these two by using curl to download protobuild.exe

Upon running package install command manually, I recieved the message Global tool 'Protobuild.Manager' is now available in the application menu

• This should probably mention that the manager has been installed to the User's ~/Applications folder, rather than the Global /Applications (Which is where I immediately looked for it)

Finally, when unpacking the .App, Protobuild appears to have lost the +x bit on Protobuild.Manager.app/Contents/MacOS/Protobuild.Manager.
This causes the .App to fail, with a generic The application “Protobuild.Manager” can’t be opened. error message.