Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/openedx/openedx-app-android
The mobile app for Android for the Open EdX Platform.
https://github.com/openedx/openedx-app-android
Last synced: about 1 month ago
JSON representation
The mobile app for Android for the Open EdX Platform.
- Host: GitHub
- URL: https://github.com/openedx/openedx-app-android
- Owner: openedx
- License: apache-2.0
- Created: 2023-03-13T09:14:43.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T09:05:59.000Z (about 2 months ago)
- Last Synced: 2024-10-29T10:07:03.854Z (about 2 months ago)
- Language: Kotlin
- Homepage:
- Size: 5.76 MB
- Stars: 18
- Watchers: 12
- Forks: 25
- Open Issues: 85
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Open edX Android
Modern vision of the mobile application for the Open edX platform from Raccoon Gang.
[Documentation](Documentation/Documentation.md)
## Building
1. Check out the source code:
git clone https://github.com/openedx/openedx-app-android.git
2. Open Android Studio and choose Open an Existing Android Studio Project.
3. Choose ``openedx-app-android``.
4. Configure `config_settings.yaml` inside `default_config` and `config.yaml` inside sub directories to point to your Open edX configuration. [Configuration Documentation](./Documentation/ConfigurationManagement.md)
5. Select the build variant ``develop``, ``stage``, or ``prod``.
6. Click the **Run** button.
## Translations
### Getting Translations for the App
Translations aren't included in the source code of this repository as of [OEP-58](https://docs.openedx.org/en/latest/developers/concepts/oep58.html). Therefore, they need to be pulled before testing or publishing to App Store.
Before retrieving the translations for the app, we need to install the requirements listed in the requirements.txt file located in the i18n_scripts directory. This can be done easily by running the following make command:
```bash
make translation_requirements
```
Then, to get the latest translations for all languages use the following command:
```bash
make pull_translations
```
This command runs [`atlas pull`](https://github.com/openedx/openedx-atlas) to download the latest translations files from the [openedx/openedx-translations](https://github.com/openedx/openedx-translations) repository. These files contain the latest translations for all languages. In the [openedx/openedx-translations](https://github.com/openedx/openedx-translations) repository each language's translations are saved as a single file e.g. `i18n/src/main/res/values-uk/strings.xml` ([example](https://github.com/openedx/openedx-translations/blob/04ccea36b8e6a9889646dfb5a5acb99686fa9ae0/translations/openedx-app-android/i18n/src/main/res/values-uk/strings.xml)). After these are pulled, each language's translation file is split into the App's modules e.g. `auth/src/main/res/values-uk/strings.xml`.
After this command is run the application can load the translations by changing the device (or the emulator) language in the settings.
### Using Custom Translations
By default, the command `make pull_translations` runs [`atlas pull`](https://github.com/openedx/openedx-atlas) with no arguments which pulls translations from the [openedx-translations repository](https://github.com/openedx/openedx-translations).
You can use custom translations on your fork of the openedx-translations repository by setting the following configuration parameters:
- `--revision` (default: `"main"`): Branch or git tag to pull translations from.
- `--repository` (default: `"openedx/openedx-translations"`): GitHub repository slug. There's a feature request to [support GitLab and other providers](https://github.com/openedx/openedx-atlas/issues/20).
Arguments can be passed via the `ATLAS_OPTIONS` environment variable as shown below:
``` bash
make ATLAS_OPTIONS='--repository=/ --revision=' pull_translations
```
Additional arguments can be passed to `atlas pull`. Refer to the [atlas documentations ](https://github.com/openedx/openedx-atlas) for more information.
### How to Translate the App
Translations are managed in the [open-edx/openedx-translations](https://app.transifex.com/open-edx/openedx-translations/dashboard/) Transifex project.
To translate the app join the [Transifex project](https://app.transifex.com/open-edx/openedx-translations/dashboard/) and add your translations to the
[`openedx-app-android`](https://app.transifex.com/open-edx/openedx-translations/openedx-app-android/) resource.
Once the resource is both 100% translated and reviewed the [Transifex integration](https://github.com/apps/transifex-integration) will automatically push it to the [openedx-translations](https://github.com/openedx/openedx-translations) repository and developers can use the translations in their app.
## API
This project targets on the latest Open edX release and rely on the relevant mobile APIs.
If your platform version is older than December 2023, please follow the instructions to use the [API Plugin](./Documentation/APIs_Compatibility.md).
## License
The code in this repository is licensed under the Apache-2.0 license unless otherwise noted.
Please see [LICENSE](https://github.com/openedx/openedx-app-android/blob/main/LICENSE) file for details.