Binder Xcode Plugin

This repository gives you access to a xcode plugin that will make it easier to use Binder within Xcode by doing most of the work in regards to adding and removing of the Binder files for you.

--- Swift only instructions, Obj-C may differ ---

Install Binder Xcode Plugin

1. Download BinderPlugin.xcplugin.zip
2. Unzip plugin file
3. Move plugin file to /Library/Application Support/Developer/Shared/Xcode/Plug-ins inside your user folder (The library folder is a hidden folder, click here for help; if the Plug-ins folder does not exist create it)
4. Restart Xcode and you should have two new fields within your Xcode 'File' menu

Add Binder Reference

1. In Xcode go to 'File > Add Binder Reference' or CTRL+SHIFT+B
2. When prompted enter your Binder endpoint (e.g. https://yourwebsite.com/YourProjectName/Binder/Binder/IOS), which is just a link to your Binder iOS Data Layer
3. Click 'Add Binder' and wait until Binder is downloaded and added. The adding process is finished when all your groups/folder in your Xcode navigator collapse
4. Add the Alamofire iOS framework in the 'Embedded Binaries' inside your project target's 'General' tab
5. You're ready to use Binder. (Make sure to import Alamofire wherever you make a Binder web call)

Remove Binder Reference

1. In Xcode go to 'File > Remove Binder Reference', which will remove all associated files from your project directory
2. Delete the Binder group from project navigator

Update Binder

1. Follow instruction from 'Remove Binder Reference' section to remove Binder
2. Follow instructions from 'Add Binder Reference' section, which will retain your Binder URL as long as Xcode is running. If Xcode has been restarted after the last time the Binder reference was added the URL will have to be entered again.

License

Copyright (c) 2016 The Board of Trustees of The University of Alabama All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of the University nor the names of the contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.