Metadata-Version: 1.2
Name: tutor-android
Version: 15.0.0
Summary: Android mobile app plugin for Tutor
Home-page: https://github.com/overhangio/tutor-android
Author: Overhang.IO
Author-email: contact@overhang.io
Maintainer: Overhang.IO
Maintainer-email: regis@overhang.io
License: AGPLv3
Project-URL: Code, https://github.com/overhangio/tutor-android
Project-URL: Issue tracker, https://github.com/overhangio/tutor-android/issues
Project-URL: Community, https://discuss.openedx.org
Description: Android application plugin for `Tutor <https://docs.tutor.overhang.io>`__
        =========================================================================
        
        This is a plugin to easily build an Android mobile application for your `Open edX <https://open.edx.org>`__ instance.
        
        Installation
        ------------
        
        ::
        
            pip install tutor-android
        
        Usage
        -----
        
        Enable the plugin and start the platform::
        
            tutor plugins enable android
            tutor local launch
        
        
        The ``.apk`` file will then be available for download at http(s)://mobile.LMS_HOST/app.apk. When running locally, this will be: http://mobile.local.overhang.io/app.apk. You can forward this address to your students for download.
        
        Building a custom Android app
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        The Android app is built from the `official edx-app-android repository <https://github.com/edx/edx-app-android/>`__. To change this repository or the app version, you can simply build a different docker image with::
        
            tutor images build \
                --build-arg ANDROID_APP_REPOSITORY=https://github.com/mycustomfork/edx-app-android \
                --build-arg ANDROID_APP_VERSION=master \
                android
        
        Releasing an Android app
        ~~~~~~~~~~~~~~~~~~~~~~~~
        
        **Note**: this is an untested feature.
        
        Releasing an Android app on the Play Store requires to build the app in release mode. To do so, modify the following Tutor settings::
        
            tutor config save \
              --set ANDROID_RELEASE_STORE_PASSWORD=yourstorepassword \
              --set ANDROID_RELEASE_KEY_PASSWORD=yourreleasekeypassword \
              --set ANDROID_RELEASE_KEY_ALIAS=yourreleasekeyalias \
              --set ANDROID_ENABLE_RELEASE_MODE=true
        
        Then, place your keystore file in ``$(tutor config printroot)/env/plugins/android/build/app/config/app.keystore``. Finally, rebuild the image by starting the "android-app" container::
        
            tutor local start -d android-app
        
        Customising the Android app
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        Customising the application, such as the logo or the background image, is currently not supported. If you are interested by this feature, please tell us about it in the Tutor `discussion forums <https://discuss.overhang.io>`_.
        
        Troubleshooting
        ---------------
        
        This Tutor plugin is maintained by Régis Behmo from `Overhang.IO <https://overhang.io>`__. Community support is available from the official `Open edX forum <https://discuss.openedx.org>`__. Do you need help with this plugin? See the `troubleshooting <https://docs.tutor.overhang.io/troubleshooting.html>`__ section from the Tutor documentation.
        
        License
        -------
        
        This software is licensed under the terms of the AGPLv3.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.7
