Metadata-Version: 2.1
Name: python-for-android
Version: 2019.6.6.post0
Summary: Android APK packager for Python scripts and apps
Home-page: https://github.com/kivy/python-for-android
Author: The Kivy team
Author-email: kivy-dev@googlegroups.com
License: MIT
Description: python-for-android
        ==================
        
        [![Build Status](https://travis-ci.org/kivy/python-for-android.svg?branch=develop)](https://travis-ci.org/kivy/python-for-android)
        [![Coverage Status](https://coveralls.io/repos/github/kivy/python-for-android/badge.svg?branch=develop&kill_cache=1)](https://coveralls.io/github/kivy/python-for-android?branch=develop)
        [![Backers on Open Collective](https://opencollective.com/kivy/backers/badge.svg)](#backers)
        [![Sponsors on Open Collective](https://opencollective.com/kivy/sponsors/badge.svg)](#sponsors)
        
        python-for-android is a packager for Python apps on Android. You can
        create your own Python distribution including the modules and
        dependencies you want, and bundle it in an APK along with your own code.
        
        Features include:
        
        -  Support for building with both Python 2 and Python 3.
        -  Different app backends including Kivy, PySDL2, and a WebView with
           Python webserver.
        -  Automatic support for most pure Python modules, and built in support
           for many others, including popular dependencies such as numpy and
           sqlalchemy.
        -  Multiple architecture targets, for APKs optimised on any given
           device.
        
        For documentation and support, see:
        
        -  Website: http://python-for-android.readthedocs.io
        -  Mailing list: https://groups.google.com/forum/#!forum/kivy-users or
           https://groups.google.com/forum/#!forum/python-android.
        
        ## Documentation
        
        Follow the [quickstart
        instructions](<https://python-for-android.readthedocs.org/en/latest/quickstart/>)
        to install and begin creating APKs.
        
        Quick instructions to start would be:
        
            pip install python-for-android
        
        or to test the master branch:
        
            pip install git+https://github.com/kivy/python-for-android.git
        
        The executable is called ``python-for-android`` or ``p4a`` (both are
        equivalent). To test that the installation worked, try::
        
            python-for-android recipes
        
        This should return a list of recipes available to be built.
        
        To build any distributions, you need to set up the Android SDK and NDK
        as described in the documentation linked above.
        
        If you did this, to build an APK with SDL2 you can try e.g.:
        
            p4a apk --requirements=kivy --private /home/asandy/devel/planewave_frozen/ --package=net.inclem.planewavessdl2 --name="planewavessdl2" --version=0.5 --bootstrap=sdl2
        
        For full instructions and parameter options, see [the
        documentation](https://python-for-android.readthedocs.io/en/latest/quickstart/#usage).
        
        ## Support
        
        If you need assistance, you can ask for help on our mailing list:
        
        -  User Group: https://groups.google.com/group/kivy-users
        -  Email: kivy-users@googlegroups.com
        
        We also have [#support Discord channel](https://chat.kivy.org/).
        
        ## Contributing
        
        We love pull requests and discussing novel ideas. Check out the Kivy
        project [contribution guide](http://kivy.org/docs/contribute.html) and
        feel free to improve python-for-android.
        
        See [our
        documentation](https://python-for-android.readthedocs.io/en/latest/contribute/)
        for more information about the python-for-android development and
        release model, but don't worry about the details. You just need to
        make a pull request, we'll take care of the rest.
        
        The following mailing list and IRC channel are used exclusively for
        discussions about developing the Kivy framework and its sister projects:
        
        -  Dev Group: https://groups.google.com/group/kivy-dev
        -  Email: kivy-dev@googlegroups.com
        
        We also have [#dev Discord channel](https://chat.kivy.org/).
        
        ## License
        
        python-for-android is released under the terms of the MIT License.
        Please refer to the LICENSE file.
        
        ## History
        
        In 2015 these tools were rewritten to provide a new, easier to use and
        extend interface. If you'd like to browse the old toolchain, its
        status is recorded for posterity at at
        https://github.com/kivy/python-for-android/tree/old_toolchain.
        
        In the last quarter of 2018 the python recipes has been changed, the
        new recipe for python3 (3.7.1) has a new build system which has been
        applied to the ancient python recipe, allowing us to bump the python2
        version number to 2.7.15. This change, unifies the build process for
        both python recipes, and probably solve some issues detected over the
        years. Also should be mentioned that this **unified python recipes**
        require to target to a **minimum api level of 21**,
        *Android 5.0 - Lollipop*, so in case the you need to build targeting an
        api level below 21, you must use an old version of python-for-android
        (<=0.7.1). All this work has been done using android ndk version r17c,
        and your build should success with that version...but be aware that the
        project is in constant development so...the ndk version will change at
        some time.
        
        Those mentioned changes has been done this way to make easier the transition
        between python3 and python2. We will slowly phase out python2 support
        towards 2020...so...if you are using python2 in your projects you should
        consider to migrate it into python3.
        
        ## Contributors
        
        This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].
        <a href="https://github.com/kivy/python-for-android/graphs/contributors"><img src="https://opencollective.com/kivy/contributors.svg?width=890&button=false" /></a>
        
        
        ## Backers
        
        Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/kivy#backer)]
        
        <a href="https://opencollective.com/kivy#backers" target="_blank"><img src="https://opencollective.com/kivy/backers.svg?width=890"></a>
        
        
        ## Sponsors
        
        Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/kivy#sponsor)]
        
        <a href="https://opencollective.com/kivy/sponsor/0/website" target="_blank"><img src="https://opencollective.com/kivy/sponsor/0/avatar.svg"></a>
        <a href="https://opencollective.com/kivy/sponsor/1/website" target="_blank"><img src="https://opencollective.com/kivy/sponsor/1/avatar.svg"></a>
        <a href="https://opencollective.com/kivy/sponsor/2/website" target="_blank"><img src="https://opencollective.com/kivy/sponsor/2/avatar.svg"></a>
        <a href="https://opencollective.com/kivy/sponsor/3/website" target="_blank"><img src="https://opencollective.com/kivy/sponsor/3/avatar.svg"></a>
        <a href="https://opencollective.com/kivy/sponsor/4/website" target="_blank"><img src="https://opencollective.com/kivy/sponsor/4/avatar.svg"></a>
        <a href="https://opencollective.com/kivy/sponsor/5/website" target="_blank"><img src="https://opencollective.com/kivy/sponsor/5/avatar.svg"></a>
        <a href="https://opencollective.com/kivy/sponsor/6/website" target="_blank"><img src="https://opencollective.com/kivy/sponsor/6/avatar.svg"></a>
        <a href="https://opencollective.com/kivy/sponsor/7/website" target="_blank"><img src="https://opencollective.com/kivy/sponsor/7/avatar.svg"></a>
        <a href="https://opencollective.com/kivy/sponsor/8/website" target="_blank"><img src="https://opencollective.com/kivy/sponsor/8/avatar.svg"></a>
        <a href="https://opencollective.com/kivy/sponsor/9/website" target="_blank"><img src="https://opencollective.com/kivy/sponsor/9/avatar.svg"></a>
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Android
Classifier: Programming Language :: C
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
