{"id":17472365,"url":"https://github.com/pranavpandey/dynamic-rating","last_synced_at":"2025-04-22T10:19:57.944Z","repository":{"id":50251305,"uuid":"510060443","full_name":"pranavpandey/dynamic-rating","owner":"pranavpandey","description":"Ask and remind users to rate the app on Android.","archived":false,"fork":false,"pushed_at":"2025-03-05T19:27:34.000Z","size":979,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-12T20:27:13.394Z","etag":null,"topics":["android","library","rate","rating","reminder"],"latest_commit_sha":null,"homepage":"https://dynamic.pranavpandey.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pranavpandey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":"pranavpandey","patreon":"pranavpandey","open_collective":"pranavpandeydev","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["paypal.me/pranavpandeydev"]}},"created_at":"2022-07-03T15:22:53.000Z","updated_at":"2025-03-05T19:27:38.000Z","dependencies_parsed_at":"2023-12-10T14:47:39.805Z","dependency_job_id":null,"html_url":"https://github.com/pranavpandey/dynamic-rating","commit_stats":{"total_commits":40,"total_committers":1,"mean_commits":40.0,"dds":0.0,"last_synced_commit":"0b2bdc15e6ce78860a89f67ee5da7e140aef080f"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranavpandey%2Fdynamic-rating","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranavpandey%2Fdynamic-rating/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranavpandey%2Fdynamic-rating/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranavpandey%2Fdynamic-rating/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pranavpandey","download_url":"https://codeload.github.com/pranavpandey/dynamic-rating/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249184671,"owners_count":21226433,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","library","rate","rating","reminder"],"created_at":"2024-10-18T17:08:52.278Z","updated_at":"2025-04-22T10:19:57.927Z","avatar_url":"https://github.com/pranavpandey.png","language":"Java","funding_links":["https://github.com/sponsors/pranavpandey","https://patreon.com/pranavpandey","https://opencollective.com/pranavpandeydev","paypal.me/pranavpandeydev","https://paypal.me/pranavpandeydev"],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"./graphics/icon.png\" height=\"160\"\u003e\n\n# Dynamic Rating\n\n[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg?)](https://www.apache.org/licenses/LICENSE-2.0.html)\n[![Release](https://img.shields.io/maven-central/v/com.pranavpandey.android/dynamic-rating)](https://search.maven.org/artifact/com.pranavpandey.android/dynamic-rating)\n\n**A library to ask and remind users to rate the app on Android 4.0 (API 14) and above.**\n\n\u003e [!IMPORTANT]\n\u003e It uses [AndroidX][androidx] so, first [migrate][androidx-migrate] your project to AndroidX.\n\u003cbr/\u003eIt is dependent on Java 8 due to the dependency on [Dynamic Utils][dynamic-utils].\n\u003cbr/\u003eSince v1.1.0, it is targeting Java 17 to provide maximum compatibility.\n\u003cbr/\u003eSince v1.2.0, the minimum SDK is Android 4.4 (API 19) to comply with the latest policies.\n\n---\n\n## Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n    - [Instance](#instance)\n    - [Initialize](#initialize)\n    - [Rate](#rate)\n    - [Sponsor](#sponsor)\n    - [Dependency](#dependency)\n- [License](#license)\n\n---\n\n## Installation\n\nIt can be installed by adding the following dependency to your `build.gradle` file:\n\n```groovy\ndependencies {\n    // For AndroidX enabled projects.\n    implementation 'com.pranavpandey.android:dynamic-rating:1.2.0'\n}\n```\n\n---\n\n## Usage\n\nIt has various `conditions` that must be met to ask for the rating from the user.\n\n\u003e For a complete reference, please read the [documentation][documentation].\n\n### Instance\n\n`DynamicRating` instance must be used to access its methods.\n\n```java\n// Get instance with application context.\nDynamicRating.getInstance(applicationContext);\n```\n\nAfter that, its various public methods can be accessed via the returned instance.\n\n### Initialize\n\nIt should be `initialized` to set the first launch `timestamp` and to increase the counter when\nrequired.\n\n```java\n// Initialize with default values.\nDynamicRating.getInstance(applicationContext).initialize();\n```\n\n### Rate\n\nCall the `shouldRate()` method to check whether we can show the rating dialog to the user\naccording to the set conditions.\n\n```java\n// Get instance and then check if we should ask to rate.\n// Returns `true` if all the rating conditions are met.\nDynamicRating.getInstance(context).initialize().shouldRate();\n```\n\n### Sponsor\n\nPlease become a [sponsor][sponsor] to get a detailed guide and priority support.\n\n### Dependency\n\nIt depends on the [dynamic-utils][dynamic-utils] and [dynamic-preferences][dynamic-preferences] \nto perform various internal operations. So, their functions can also be used to perform other \nuseful operations.\n\n---\n\n## Translations\n\n- Chinese (Traditional) (zh-rTW) - 人工知能\n\n---\n\n## Author\n\nPranav Pandey\n\n[![GitHub](https://img.shields.io/github/followers/pranavpandey?label=GitHub\u0026style=social)](https://github.com/pranavpandey)\n[![Follow on Twitter](https://img.shields.io/twitter/follow/pranavpandeydev?label=Follow\u0026style=social)](https://twitter.com/intent/follow?screen_name=pranavpandeydev)\n[![Donate via PayPal](https://img.shields.io/static/v1?label=Donate\u0026message=PayPal\u0026color=blue)](https://paypal.me/pranavpandeydev)\n\n---\n\n## License\n\n    Copyright 2022-2024 Pranav Pandey\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n\n\n[androidx]: https://developer.android.com/jetpack/androidx\n[androidx-migrate]: https://developer.android.com/jetpack/androidx/migrate\n[documentation]: https://pranavpandey.github.io/dynamic-rating\n[sponsor]: https://github.com/sponsors/pranavpandey\n[dynamic-utils]: https://github.com/pranavpandey/dynamic-utils\n[dynamic-preferences]: https://github.com/pranavpandey/dynamic-preferences\n[dynamic-support]: https://github.com/pranavpandey/dynamic-support\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranavpandey%2Fdynamic-rating","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpranavpandey%2Fdynamic-rating","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranavpandey%2Fdynamic-rating/lists"}