add the first version of kivyreview

Author: PaulCreusy

README.md

@@ -1 +1,54 @@
 # Kivy In-App-Review
+
+This repository contains the information to integrate in app review using the Google Play Store API for Android applications developed with Kivy.
+
+## License
+
+This module is licensed under the Apache License version 2.0.
+
+## Integration
+
+> :warning: Warning 
+> This module has only been tested for android API versions between 28 and 34. This might not work for older versions.
+
+To integrate this module in your application you have to follow a few steps:
+
+1. **Copy the code inside your folders** : You have to copy the `src` folder and the `kivyreview.py` file inside your own code arborescence. If you copy them at the root of your project, you can use directly the following instructions, if you prefer to rename the `src` folder or move the files somewhere else, do not forget to adapt the paths in the instructions to match the ones you used.
+
+> :warning: Warning 
+> Do not rename the `ReviewHandler.java` file unless you know what you are doing. You will need to adapt the java code in this case.
+
+2. **Update your `buildozer.spec` file** : Some modifications needs to be done in the `buildozer.spec` file:
+
+Search the line allowing to include gradle dependencies during compilation.
+
+```
+# android.gradle_dependencies =
+```
+
+It needs to be replaced by:
+
+```
+ndroid.gradle_dependencies = com.google.android.play:core:1.10.0
+```
+
+> :pencil: Note 
+> If you already have other dependencies, just add a comma between them.
+
+Search the line allowing to include additional java code in your application.
+
+```
+# android.add_src =
+```
+
+It needs to be replaced by:
+
+```
+android.add_src = src
+```
+
+3. **Call the `request_review` where yo need it** : You can now import the `request_review` function from the `kivyreview` module in your code and call it where you need it.
+
+## Bugs and issues
+
+If you encounter a problem or a bug during this procedure, please do not hesitate to raise an issue on this github repository.

kivyreview.py

@@ -0,0 +1,18 @@
+from kivy.utils import platform
+
+
+if platform == "android":
+    from android import PythonJavaClass, autoclass, java_method, mActivity
+    from android.runnable import run_on_ui_thread
+
+    context = mActivity.getApplicationContext()
+    YourReviewHandler = autoclass('org.org.kivyreview.ReviewHandler')
+    PythonActivity = autoclass('org.kivy.android.PythonActivity')
+
+    def request_review(*_):
+        activity = PythonActivity.mActivity
+        review_handler = YourReviewHandler(activity)
+        review_handler.requestReview()
+else:
+    def request_review(*_):
+        print("In app review is only possible on android devices.")

src/ReviewHandler.java

@@ -0,0 +1,46 @@
+package org.org.kivyreview;
+
+import android.app.Activity;
+import com.google.android.play.core.review.ReviewInfo;
+import com.google.android.play.core.review.ReviewManager;
+import com.google.android.play.core.tasks.Task;
+
+public class ReviewHandler {
+
+    private Activity mActivity;
+    private ReviewManager mReviewManager;
+
+    public ReviewHandler(Activity activity) {
+        mActivity = activity;
+        mReviewManager = com.google.android.play.core.review.ReviewManagerFactory.create(mActivity);
+    }
+
+    public void requestReview() {
+        Task<ReviewInfo> request = mReviewManager.requestReviewFlow();
+        request.addOnCompleteListener(task -> {
+            if (task.isSuccessful()) {
+                ReviewInfo reviewInfo = task.getResult();
+                launchReviewFlow(reviewInfo);
+            } else {
+                // Handle error when requesting review flow
+                // For example, show a fallback review prompt
+                showFallbackReviewPrompt();
+            }
+        });
+    }
+
+    private void launchReviewFlow(ReviewInfo reviewInfo) {
+        Task<Void> flow = mReviewManager.launchReviewFlow(mActivity, reviewInfo);
+        flow.addOnCompleteListener(task -> {
+            // Review flow launched, handle success or failure here
+            // For example, log completion or show a thank you message
+        });
+    }
+
+    private void showFallbackReviewPrompt() {
+        // Fallback mechanism to ask for user feedback or redirect to the Play Store for
+        // review
+        // You can implement a custom dialog or redirect the user to the app's Play
+        // Store page
+    }
+}