Loklak Wok for Android
Loklak Wok Android is a message harvesting peer for the loklak_server.
Users can also search tweets from the app, the displayed tweets are latest tweets, tweets containing images and videos. Along with that, the app provides tweet posting feature. Users can directly post tweet from the app. Not only text, but images can also be tweeted from the app.
Screenshots of app
Please join our mailing list to discuss questions regarding the project: https://groups.google.com/forum/#!forum/opntec-dev
Our chat channel is on gitter here: https://gitter.im/loklak/loklak.
Development Environment Setup
Clone the repository
$ git clone https://github.com/fossasia/loklak_wok_android.git
Before you begin, you should already have the Android Studio SDK downloaded and set up correctly. You can find a guide on how to do this here: Setting up Android Studio
Setting up the Android Project
Download the loklak_wok_android project source. You can do this either by forking and cloning the repository (recommended if you plan on pushing changes) or by downloading it as a ZIP file and extracting it.
Open Android Studio, you will see a Welcome to Android window. Under Quick Start, select Import Project (Eclipse ADT, Gradle, etc.)
Navigate to the directory where you saved the loklak_wok_android project, select this folder.
Once this process is complete and Android Studio opens, check the Console for any build errors. Note: If you receive a Gradle sync error titled, "failed to find ...", you should click on the link below the error message (if available) that says Install missing platform(s) and sync project and allow Android studio to fetch you what is missing.
Once all build errors have been resolved, you should be all set to build the app and test it.
To Build the app, go to Build>Make Project (or alternatively press the Make Project icon in the toolbar).
If the app was built successfully, you can test it by running it on either a real device or an emulated one by going to Run>Run 'app' or presing the Run icon in the toolbar.
The project uses lambda expressions and RxJava heavily. So, if you are new to these, the following resources would be helpful to get you started:
- Lambda Expressions
Contributions, Bug Reports and Feature Requests
This is an Open Source project and we would be happy to see contributors who report bugs and file feature requests submitting pull requests as well. Please report issues here https://github.com/fossasia/loklak_wok_android/issues.
- master All development goes on in this branch. If you're making a contribution, you are supposed to make a pull request to master. PRs to master must pass a build check on Travis.
- apk This branch contains apks, that are automatically generated on merging the latest pull request.
Code Style Guidelines
For contributions please read the CODESTYLE carefully. An additional rule: Maximum 100 characters per line.
Try to remove as much warnings (yellow markings on the right side of Android Studio) as possible, It's not completely possible to remove all the warnings, but over a period of time, we should try to make it as complete as possible.
This is licensed under LGPL 2.1.