A basic task management app, designed as a homage to Realmac Software's Clear, with their knowledge and permission.
Warning: This project is very much a work in progress, being used as a testbed for new Realm technologies. It is in no way a fully feature-complete product, nor is it ever meant to be an actual competitor for the Clear app.
- Xcode 8.
- CocoaPods 1.0.1.
- Android Studio 2.2 with Android API 25
- An emulator, Genymotion or a real device attached and running.
1. Get the Realm Object Server
The Realm Tasks apps uses a Realm Object Server to synchronize tasks between them.
The fastest way to get access to a Realm Object Server is by signing up for a free Realm Cloud trial: https://cloud.realm.io/login/sign-up.
2. Build and Run RealmTasks
First download or clone this repo.
pod installfrom the
RealmTasks Appledirectory in this repo.
RealmTasks Apple/RealmTasks.xcworkspacewith Xcode 8.
- Select either the "RealmTasks macOS" or "RealmTasks iOS" depending on which platform you'd like to try the app on.
- Click the "Build and Run" icon in the upper left of Xcode (play icon).
- When the app launches, tap/click "Register" if this is the first time you're trying the app, or "Log In" if you've already created an account.
- Optional: If you'd like to run the app on a physical iPhone, you'll need to have code signing set up with Xcode, and the iPhone should be connected on the same local network as your Mac running the object server.
- Go to the
RealmTasks Androiddirectory in this repo.
- The RealmTask app should now be installed on all attached Android devices and emulators. You need to launch the app manually.
At this point, you can login, start creating items, managing lists, and you'll see your actions reflected in real time in other running instances of the app wether it is the Android, iOS or macOS app.
We recommend that you run at least two instances of the app together to really show off sync in action.
3. Access Realm Files with Realm Studio
Another useful tool is Realm Studio which is available for macOS, Linux, Windows and allows developers to inspect and manage Realms. Realm Studio is recommended for all developers and can be downloaded from the Realm web site.
- Launch the Realm Studio app obtained above and click "Connect to Realm Object Server".
- Press "Connect" to connect to the Realm Object Server running locally.
- You now see a list of all Realms on the server. The RealmTask file is named
RealmTasks is designed to be cross platform, so versions for all platforms/languages should be able to sync with each other. There may be slight discrepancies in terms of functionality which will be listed here.
- Authentication against Azure Active Directory is only supported in the Xamarin version.
Third Party Dependencies
The following modules will be installed as part of the CocoaPods installation:
- Realm Swift - The Swift version of the Realm Mobile Database.
- Realm LoginKit - A Realm control for logging in to Realm servers.
- Cartography - A library for making it easier to define auto layout constraints in code.
- SwiftLint - A tool for validating the quality of Swift code.
See CONTRIBUTING.md for more details!
The source code for RealmTasks is licensed under the Apache License 2.0.