Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alcatraz/Alcatraz

Package manager for Xcode
https://github.com/alcatraz/Alcatraz

Last synced: about 1 month ago
JSON representation

Package manager for Xcode

Awesome Lists containing this project

README

        

![Alcatraz](http://alcatraz.io/images/[email protected])

Alcatraz is an open-source package manager for Xcode 7. It lets you discover and install plugins, templates and color schemes without the need for manually cloning or copying files. It installs itself as a part of Xcode and it feels like home.

Please note that **plugins are not supported by Xcode 8**. See [#475](https://github.com/alcatraz/Alcatraz/issues/475) for more information.

[![Stories in Ready](https://badge.waffle.io/alcatraz/Alcatraz.svg?label=ready)](https://waffle.io/alcatraz/Alcatraz)
[![Build Status](https://travis-ci.org/alcatraz/Alcatraz.svg?branch=master)](https://travis-ci.org/alcatraz/Alcatraz)
[![Alcatraz chat](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/alcatraz/alcatraz)
![Package Manager UI](http://alcatraz.io/images/[email protected])

## Installation

To install, open up your terminal and paste this:

``` bash
curl -fsSL https://raw.github.com/alcatraz/Alcatraz/master/Scripts/install.sh | sh
```
or download the repository from Github and build it in Xcode. You'll need to restart Xcode after the installation.

Alcatraz requires Xcode Command Line Tools, which can be installed in Xcode via `Preferences > Downloads`.

## Requirements

Alcatraz only supports Xcode 7.

## Usage

Select `Package Manager` from the `Window` menu, then check or uncheck packages to install or remove them. You'll need to restart Xcode after installing plugins or templates. Installed plugins are checked and updated each time Alcatraz is launched.

## I want to submit my package!

Fork the [Alcatraz package repository](https://github.com/alcatraz/alcatraz-packages) and include your package with `name`, `description`, `URL`, and optional `screenshot`. Don't forget to submit a pull request. Further instructions are included in the package repository documentation.

## Development

Alcatraz has a few [contribution guidelines](https://github.com/alcatraz/Alcatraz/blob/master/CONTRIBUTING.md), for anyone looking to make it more awesome.

## Troubleshooting

If "nothing" happens when installing packages, try the following self-help steps:

1. Verify which copy (if more than one are installed) of git is being run (`which git`).
2. Make sure you're running a recent version of git (`git --version`).
3. If you've used Xcode developer preview releases in the past, make certain Xcode isn't stuck using an inappropriate developer path by resetting it (`sudo xcode-select --reset`).

## Uninstall

Open up your terminal and paste this:

```bash
rm -rf ~/Library/Application\ Support/Developer/Shared/Xcode/Plug-ins/Alcatraz.xcplugin
```

To remove all packages installed via Alcatraz, run `rm -rf ~/Library/Application\ Support/Alcatraz/`

## Team

[Marin Usalj](http://supermar.in) ([@supermarin](https://github.com/supermarin))

[Delisa Mason](http://delisa.me) ([@kattrali](https://github.com/kattrali))

Jurre Stender ([@jurre](https://github.com/jurre))

[Guillaume Algis](https://twitter.com/guillaumealgis) ([@guillaume-algis](https://github.com/guillaume-algis))