Skip to content

Latest commit

 

History

History
118 lines (93 loc) · 4.53 KB

README.md

File metadata and controls

118 lines (93 loc) · 4.53 KB

AdMob support for Kivy

Build Status pypi Python Version Code Climate Code Climate Code style: black docs

Allows developers to monetize their Kivy mobile applications using Google AdMob.

  • No need to change internal Android project manifest templates or Java code.
  • Supports banner, interstitial, and rewarded video ads.

For more information, please read the official documentation.

Installation

You can install KivMob with the following command.

$ pip3 install kivmob

Demo Screenshot

Quickstart

Create a new folder containing main.py and buildozer.spec.

$ mkdir kivmob-quickstart
$ cd kivmob-quickstart
$ touch main.py
$ buildozer init

Copy the following into main.py.

from kivmob import KivMob, TestIds
from kivy.app import App
from kivy.uix.button import Button

class KivMobTest(App):
    
    def build(self):
        self.ads = KivMob(TestIds.APP)
        self.ads.new_interstitial(TestIds.INTERSTITIAL)
        self.ads.request_interstitial()
        return Button(text='Show Interstitial',
                      on_release=lambda a:self.ads.show_interstitial())
                      
    def on_resume(self):
        self.ads.request_interstitial()

KivMobTest().run()

Make the following modifications to your buildozer.spec file.

requirements = kivy, android, jnius, kivmob
...
android.permissions = INTERNET, ACCESS_NETWORK_STATE
android.api = 30
android.minapi = 21
android.sdk = 24
android.ndk = 19b
android.gradle_dependencies = 'com.google.firebase:firebase-ads:10.2.0'
p4a.branch = master
android.meta_data = com.google.android.gms.ads.APPLICATION_ID=ca-app-pub-3940256099942544~3347511713

Finally, build and launch the application.

$ buildozer android debug deploy run

App Showcase

Please open a pull request or project issue if you would like your KivMob app featured in this README.

App Play Store Link Developer
Gloworld : The Marbles game https://play.google.com/store/apps/details?id=com.worldglowfree.dom.com.world.glowfree&hl=en thegameguy
MIUI Hidden Settings https://play.google.com/store/apps/details?id=com.ceyhan.sets Yunus Ceyhan
PyTool USB Serial Free https://play.google.com/store/apps/details?id=com.quanlin.pytoolusbserialfree Quan Lin
Easy Weather - Live Weather with 5 day forecast https://play.google.com/store/apps/details?id=org.sivaram.easyweather Sivaram Yadav Nalliboyana
La Carta https://play.google.com/store/apps/details?id=com.blogspot.roberware.lacarta RoberWare

Other

KivMob is an open source project not associated with AdMob. Please abide by their policies when designing and testing your application.