Skip to content

Latest commit

 

History

History
83 lines (52 loc) · 2.75 KB

README.md

File metadata and controls

83 lines (52 loc) · 2.75 KB

iOctocat

… is a GitHub app for your iOS devices (iPad, iPhone and iPod Touch). It is open source and available on the App Store

For further information visit the project website.

Your participation is welcome. Feel free to fork, add missing features or report issues :)

Building and Debugging

In order to build iOctocat on your own, install the following prerequisites:

Here are some tips for providing debugging information along with issues. iOctocat logs all API calls and in the console you will find the debugging output.

  • Clone the repo and open the terminal with the directory you cloned it into

    git clone git://github.com/dennisreimann/ioctocat.git
cd ioctocat

  • Install the submodules:

    git submodule update --init

  • Install the dependencies

    pod install

  • Create the HockeySDK.plist file by copying the sample:

    cp HockeySDK{.sample,}.plist

  • Open the project in Xcode

    open iOctocat.xcworkspace

  • Select "iOctocat > iPhone Simulator" in the upper left corner

  • Build and run the app by pressing the play button

  • Activate the debug console by selecting "View > Debug Area > Activate Console"

  • Clear the console (Cmd + K)

  • Move to where the error occurs

  • Copy the output in the console and attach it to your bug report

Running the tests

To run the (sparse) test suite, you can build/test the iOctocat Unit Tests scheme.

To make the tests run from the command line you have to install ios-sim:

brew install ios-sim

Use this command to run the tests from the iOctocat directory:

TestScripts/run_tests_from_cli.rb

To run the tests on every file change, you can install Guard and its accompanying ruby gems via Bundler:

bundle install

After that you can start guard with this command:

bundle exec guard

Attribution

iOctocat uses some third party components and libraries: