diff --git a/README.md b/README.md index 78a7126..aa328d4 100644 --- a/README.md +++ b/README.md @@ -69,16 +69,17 @@ KivMobTest().run() Make the following modifications to your buildozer.spec file. ``` -requirements = kivy, android, jnius, kivmob +requirements = python3, kivy, android, jnius, kivmob ... android.permissions = INTERNET, ACCESS_NETWORK_STATE -android.api = 30 +android.api = 33 android.minapi = 21 -android.sdk = 24 -android.ndk = 19b -android.gradle_dependencies = 'com.google.firebase:firebase-ads:10.2.0' +android.sdk = 33 +android.ndk = 25b +android.gradle_dependencies = 'com.google.firebase:firebase-ads:21.4.0' +android.enable_androidx = True p4a.branch = master -android.meta_data = com.google.android.gms.ads.APPLICATION_ID=ca-app-pub-3940256099942544~3347511713 +android.meta_data = 'com.google.android.gms.ads.APPLICATION_ID = ca-app-pub-3940256099942544~3347511713' ``` Finally, build and launch the application. diff --git a/demo/buildozer.spec b/demo/buildozer.spec index 72d2780..c103f86 100644 --- a/demo/buildozer.spec +++ b/demo/buildozer.spec @@ -22,13 +22,14 @@ source.include_exts = py,png,jpg,kv,atlas #source.exclude_exts = spec # (list) List of directory to exclude (let empty to not exclude anything) -#source.exclude_dirs = tests, bin +#source.exclude_dirs = tests, bin, venv # (list) List of exclusions using pattern matching +# Do not prefix with './' #source.exclude_patterns = license,images/*/*.jpg # (str) Application versioning (method 1) -version = 1.0 +version = 0.1 # (str) Application versioning (method 2) # version.regex = __version__ = ['"](.*)['"] @@ -36,17 +37,14 @@ version = 1.0 # (list) Application requirements # comma separated e.g. requirements = sqlite3,kivy -requirements = hostpython2,python3,kivy,jnius,android,kivmob +requirements = python3, kivy, jnius, android, kivmob # (str) Custom source folders for requirements # Sets custom source for any requirements with recipes # requirements.source.kivy = ../../kivy -# (list) Garden requirements -#garden_requirements = - # (str) Presplash of the application -#presplash.filename = %(source.dir)s/assets/kivmob-presplash.png +#presplash.filename = %(source.dir)s/data/presplash.png # (str) Icon of the application #icon.filename = %(source.dir)s/data/icon.png @@ -65,10 +63,10 @@ orientation = portrait # author = © Copyright Info # change the major version of python used by the app -osx.python_version = 3 +#osx.python_version = 3 # Kivy version to use -osx.kivy_version = 1.9.1 +#osx.kivy_version = 1.9.1 # # Android specific @@ -77,27 +75,40 @@ osx.kivy_version = 1.9.1 # (bool) Indicate if the application should be fullscreen or not fullscreen = 0 -# (string) Presplash background color (for new android toolchain) +# (string) Presplash background color (for android toolchain) # Supported formats are: #RRGGBB #AARRGGBB or one of the following names: # red, blue, green, black, white, gray, cyan, magenta, yellow, lightgray, # darkgray, grey, lightgrey, darkgrey, aqua, fuchsia, lime, maroon, navy, # olive, purple, silver, teal. #android.presplash_color = #FFFFFF +# (string) Presplash animation using Lottie format. +# see https://lottiefiles.com/ for examples and https://airbnb.design/lottie/ +# for general documentation. +# Lottie files can be created using various tools, like Adobe After Effect or Synfig. +#android.presplash_lottie = "path/to/lottie/file.json" + +# (str) Adaptive icon of the application (used if Android API level is 26+ at runtime) +#icon.adaptive_foreground.filename = %(source.dir)s/data/icon_fg.png +#icon.adaptive_background.filename = %(source.dir)s/data/icon_bg.png + # (list) Permissions android.permissions = INTERNET, ACCESS_NETWORK_STATE +# (list) features (adds uses-feature -tags to manifest) +#android.features = android.hardware.usb.host + # (int) Target Android API, should be as high as possible. -android.api = 28 +android.api = 33 -# (int) Minimum API your APK will support. +# (int) Minimum API your APK / AAB will support. android.minapi = 21 # (int) Android SDK version to use -android.sdk = 24 +android.sdk = 33 # (str) Android NDK version to use -android.ndk = 19b +android.ndk = 25b # (int) Android NDK API to use. This is the minimum API your app will support, it should usually match android.minapi. #android.ndk_api = 21 @@ -123,10 +134,26 @@ android.ndk = 19b # agreements. This is intended for automation only. If set to False, # the default, you will be shown the license when first running # buildozer. -# android.accept_sdk_license = False +android.accept_sdk_license = True # (str) Android entry point, default is ok for Kivy-based app -#android.entrypoint = org.renpy.android.PythonActivity +#android.entrypoint = org.kivy.android.PythonActivity + +# (str) Full name including package path of the Java class that implements Android Activity +# use that parameter together with android.entrypoint to set custom Java class instead of PythonActivity +#android.activity_class_name = org.kivy.android.PythonActivity + +# (str) Extra xml to write directly inside the element of AndroidManifest.xml +# use that parameter to provide a filename from where to load your custom XML code +#android.extra_manifest_xml = ./src/android/extra_manifest.xml + +# (str) Extra xml to write directly inside the tag of AndroidManifest.xml +# use that parameter to provide a filename from where to load your custom XML arguments: +#android.extra_manifest_application_arguments = ./src/android/extra_manifest_application_arguments.xml + +# (str) Full name including package path of the Java class that implements Python Service +# use that parameter to set custom Java class instead of PythonService +#android.service_class_name = org.kivy.android.PythonService # (str) Android app theme, default is ok for Kivy-based app # android.apptheme = "@android:style/Theme.NoTitleBar" @@ -150,13 +177,22 @@ android.ndk = 19b # directory containing the files) #android.add_src = -# (list) Android AAR archives to add (currently works only with sdl2_gradle -# bootstrap) +# (list) Android AAR archives to add #android.add_aars = -# (list) Gradle dependencies to add (currently works only with sdl2_gradle -# bootstrap) -android.gradle_dependencies = 'com.google.firebase:firebase-ads:10.2.0' +# (list) Put these files or directories in the apk assets directory. +# Either form may be used, and assets need not be in 'source.include_exts'. +# 1) android.add_assets = source_asset_relative_path +# 2) android.add_assets = source_asset_path:destination_asset_relative_path +#android.add_assets = + +# (list) Gradle dependencies to add +android.gradle_dependencies = 'com.google.firebase:firebase-ads:21.4.0' + +# (bool) Enable AndroidX support. Enable when 'android.gradle_dependencies' +# contains an 'androidx' package, or any package from Kotlin source. +# android.enable_androidx requires android.api >= 28 +android.enable_androidx = True # (list) add java compile options # this can for example be necessary when importing certain java libraries using the 'android.gradle_dependencies' option @@ -173,7 +209,7 @@ android.gradle_dependencies = 'com.google.firebase:firebase-ads:10.2.0' # can be necessary to solve conflicts in gradle_dependencies # please enclose in double quotes # e.g. android.add_packaging_options = "exclude 'META-INF/common.kotlin_module'", "exclude 'META-INF/*.kotlin_module'" -#android.add_gradle_repositories = +#android.add_packaging_options = # (list) Java classes to add as activities to the manifest. #android.add_activities = com.example.ExampleActivity @@ -203,7 +239,7 @@ android.gradle_dependencies = 'com.google.firebase:firebase-ads:10.2.0' #android.wakelock = False # (list) Android application meta-data to set (key=value format) -android.meta_data = com.google.android.gms.APPLICATION_ID = ca-app-pub-3940256099942544~3347511713 +android.meta_data = 'com.google.android.gms.APPLICATION_ID = ca-app-pub-3940256099942544~3347511713' # (list) Android library project to add (will be added in the # project.properties automatically.) @@ -215,22 +251,60 @@ android.meta_data = com.google.android.gms.APPLICATION_ID = ca-app-pub-394025609 # (str) Android logcat filters to use android.logcat_filters = *:S python:D +# (bool) Android logcat only display log for activity's pid +#android.logcat_pid_only = False + +# (str) Android additional adb arguments +#android.adb_args = -H host.docker.internal + # (bool) Copy library instead of making a libpymodules.so #android.copy_libs = 1 -# (str) The Android arch to build for, choices: armeabi-v7a, arm64-v8a, x86, x86_64 -android.arch = armeabi-v7a +# (list) The Android archs to build for, choices: armeabi-v7a, arm64-v8a, x86, x86_64 +# In past, was `android.arch` as we weren't supporting builds for multiple archs at the same time. +android.archs = arm64-v8a, armeabi-v7a + +# (int) overrides automatic versionCode computation (used in build.gradle) +# this is not the same as app version and should only be edited if you know what you're doing +# android.numeric_version = 1 + +# (bool) enables Android auto backup feature (Android API >=23) +android.allow_backup = True + +# (str) XML file for custom backup rules (see official auto backup documentation) +# android.backup_rules = + +# (str) If you need to insert variables into your AndroidManifest.xml file, +# you can do so with the manifestPlaceholders property. +# This property takes a map of key-value pairs. (via a string) +# Usage example : android.manifest_placeholders = [myCustomUrl:\"org.kivy.customurl\"] +# android.manifest_placeholders = [:] + +# (bool) disables the compilation of py to pyc/pyo files when packaging +# android.no-compile-pyo = True + +# (str) The format used to package the app for release mode (aab or apk or aar). +# android.release_artifact = aab + +# (str) The format used to package the app for debug mode (apk or aar). +# android.debug_artifact = apk # # Python for android (p4a) specific # -# (str) python-for-android fork to use, defaults to upstream (kivy) +# (str) python-for-android URL to use for checkout +#p4a.url = + +# (str) python-for-android fork to use in case if p4a.url is not specified, defaults to upstream (kivy) #p4a.fork = kivy # (str) python-for-android branch to use, defaults to master p4a.branch = master +# (str) python-for-android specific commit to use, defaults to HEAD, must be within p4a.branch +#p4a.commit = HEAD + # (str) python-for-android git clone directory (if empty, it will be automatically cloned from github) #p4a.source_dir = @@ -246,6 +320,16 @@ p4a.branch = master # (int) port number to specify an explicit --port= p4a argument (eg for bootstrap flask) #p4a.port = +# Control passing the --use-setup-py vs --ignore-setup-py to p4a +# "in the future" --use-setup-py is going to be the default behaviour in p4a, right now it is not +# Setting this to false will pass --ignore-setup-py, true will pass --use-setup-py +# NOTE: this is general setuptools integration, having pyproject.toml is enough, no need to generate +# setup.py if you're using Poetry, but you need to add "toml" to source.include_exts. +#p4a.setup_py = false + +# (str) extra command line arguments to pass when invoking pythonforandroid.toolchain +#p4a.extra_args = + # # iOS specific @@ -254,23 +338,44 @@ p4a.branch = master # (str) Path to a custom kivy-ios folder #ios.kivy_ios_dir = ../kivy-ios # Alternately, specify the URL and branch of a git checkout: -ios.kivy_ios_url = https://github.com/kivy/kivy-ios -ios.kivy_ios_branch = master +#ios.kivy_ios_url = https://github.com/kivy/kivy-ios +#ios.kivy_ios_branch = master # Another platform dependency: ios-deploy # Uncomment to use a custom checkout #ios.ios_deploy_dir = ../ios_deploy # Or specify URL and branch -ios.ios_deploy_url = https://github.com/phonegap/ios-deploy -ios.ios_deploy_branch = 1.7.0 +#ios.ios_deploy_url = https://github.com/phonegap/ios-deploy +#ios.ios_deploy_branch = 1.10.0 + +# (bool) Whether or not to sign the code +#ios.codesign.allowed = false # (str) Name of the certificate to use for signing the debug version # Get a list of available identities: buildozer ios list_identities #ios.codesign.debug = "iPhone Developer: ()" +# (str) The development team to use for signing the debug version +#ios.codesign.development_team.debug = + # (str) Name of the certificate to use for signing the release version #ios.codesign.release = %(ios.codesign.debug)s +# (str) The development team to use for signing the release version +#ios.codesign.development_team.release = + +# (str) URL pointing to .ipa file to be installed +# This option should be defined along with `display_image_url` and `full_size_image_url` options. +#ios.manifest.app_url = + +# (str) URL pointing to an icon (57x57px) to be displayed during download +# This option should be defined along with `app_url` and `full_size_image_url` options. +#ios.manifest.display_image_url = + +# (str) URL pointing to a large icon (512x512px) to be used by iTunes +# This option should be defined along with `app_url` and `display_image_url` options. +#ios.manifest.full_size_image_url = + [buildozer] @@ -283,7 +388,7 @@ warn_on_root = 1 # (str) Path to build artifact storage, absolute or relative to spec file # build_dir = ./.buildozer -# (str) Path to build output (i.e. .apk, .ipa) storage +# (str) Path to build output (i.e. .apk, .aab, .ipa) storage # bin_dir = ./bin # ----------------------------------------------------------------------------- diff --git a/docs/tutorials.rst b/docs/tutorials.rst index dffa0fc..acf0c57 100644 --- a/docs/tutorials.rst +++ b/docs/tutorials.rst @@ -23,14 +23,15 @@ Modify buildozer.spec as such: .. code-block:: sh - requirements = hostpython2, kivy, android, jnius, kivmob + requirements = python3, kivy, android, jnius, kivmob ... android.permissions = INTERNET, ACCESS_NETWORK_STATE - android.api = 27 + android.api = 33 android.minapi = 21 - android.sdk = 24 - android.ndk = 17b - android.gradle_dependencies = 'com.google.firebase:firebase-ads:10.2.0' + android.sdk = 33 + android.ndk = 25b + android.gradle_dependencies = 'com.google.firebase:firebase-ads:21.4.0' + android.enable_androidx = True p4a.branch = master # For test ads, use application ID ca-app-pub-3940256099942544~3347511713 android.meta_data = com.google.android.gms.ads.APPLICATION_ID={ADMOB_APP_ID_HERE} @@ -122,4 +123,4 @@ functionality can be handled with a class implementing RewardedListenerInterface self.ads.load_rewarded_ad(TestIds.REWARDED_VIDEO) if __name__ == "__main__": - RewardedVideoTest().run() \ No newline at end of file + RewardedVideoTest().run()