This repository contains the source code for building the native Toggl Android and iOS applications. These applications are build using Xamarin products to allow for maximum code reuse and faster development times.
The repository consists of the following projects:
- Phoebe - shared data models and business logic across platforms
- Joey - Android application (UI & Android specific code)
- Ross - iOS application (UI & iOS specific code)
- Tests - unit tests for testing code in Phoebe
Phoebe has several project files (Phoebe.Android.csproj, Phoebe.iOS.csproj and Phoebe.Desktop.csproj) which compile the same code for different target platforms (Android, iOS and desktop).
You should begin by initializing git submodules we reference:
$ git submodule init
$ git submodule update
You also need to restore NuGet packages for the solution. In Xamarin Studio 3.0 you can find the Restore Packages under Project menu.
Before compiling any of the projects, there is one last file you need to edit. Phoebe/Build.cs contains various configuration parameters for different components, which you need to fill in for the app to run.
Want to contribute? Great! Just fork the project, make your changes and submit a pull request.
We're lazy, so instead of having official coding style, we have a Xamarin Studio code formatting settings. And our IDEs configured to automatically format the file when saving.
If you plan on contributing it's best to have the same settings. You can copy the
Default.mdpolicy.xml to
~/Library/XamarinStudio-4.0/Policies/ directory (on OSX).
Then make sure that you have "Custom" policy selected under Xamarin Studio settings > Source Code > Code Formatting > C# source code. And don't forget to turn on "Format document on save" under Xamarin Studio settings > Text Editor > Behavior.
Want to write open source code for a living? Love writing mobile applications using Xamarin technologies? Sick of the daily commute to the office?
Check out our jobs page for the Xamarin/.NET mobile developer position.
The code in this repository is licensed under the BSD 3-clause license.