{"id":21130146,"url":"https://github.com/kobakei/Android-RateThisApp","last_synced_at":"2025-07-09T01:32:31.242Z","repository":{"id":57725938,"uuid":"9349244","full_name":"kobakei/Android-RateThisApp","owner":"kobakei","description":"Android library to show \"Rate this app\" dialog","archived":false,"fork":false,"pushed_at":"2020-05-08T09:53:49.000Z","size":1468,"stargazers_count":549,"open_issues_count":42,"forks_count":164,"subscribers_count":22,"default_branch":"master","last_synced_at":"2024-04-14T09:10:28.929Z","etag":null,"topics":["android","rating","view"],"latest_commit_sha":null,"homepage":null,"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/kobakei.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-04-10T15:26:49.000Z","updated_at":"2024-04-04T07:03:16.000Z","dependencies_parsed_at":"2022-09-02T03:41:34.788Z","dependency_job_id":null,"html_url":"https://github.com/kobakei/Android-RateThisApp","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kobakei%2FAndroid-RateThisApp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kobakei%2FAndroid-RateThisApp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kobakei%2FAndroid-RateThisApp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kobakei%2FAndroid-RateThisApp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kobakei","download_url":"https://codeload.github.com/kobakei/Android-RateThisApp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225476373,"owners_count":17480215,"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","rating","view"],"created_at":"2024-11-20T05:32:19.579Z","updated_at":"2024-11-20T05:32:27.344Z","avatar_url":"https://github.com/kobakei.png","language":"Java","funding_links":[],"categories":["Libs"],"sub_categories":["\u003cA NAME=\"Widget\"\u003e\u003c/A\u003eWidget"],"readme":"Android-RateThisApp\n===================\n\n[![Build Status](https://circleci.com/gh/kobakei/Android-RateThisApp.svg?style=shield)](https://circleci.com/gh/kobakei/Android-RateThisApp/tree/master)\n[![Download](https://api.bintray.com/packages/kobakei/maven/ratethisapp/images/download.svg) ](https://bintray.com/kobakei/maven/ratethisapp/_latestVersion)\n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-Android--RateThisApp-green.svg?style=true)](https://android-arsenal.com/details/1/2893)\n\nAndroid-RateThisApp is an library to show \"Rate this app\" dialog.\n\n![Screen shot](https://raw.github.com/kobakei/Android-RateThisApp/master/screenshot_resized.png)\n\nThe library monitors the following status\n\n* How many times is the app launched\n* How long days does it take from the app installation\n\nand show a dialog to engage users to rate the app in Google Play.\n\n## Getting Started\n\n### Dependency\n\n```groovy\ndependencies {\n    compile 'io.github.kobakei:ratethisapp:x.y.z'\n}\n```\n\nx.y.z is [ ![Download](https://api.bintray.com/packages/kobakei/maven/ratethisapp/images/download.svg) ](https://bintray.com/kobakei/maven/ratethisapp/_latestVersion)\n\n**NOTICE**: From 1.0.0, group ID has been changed from `com.kobakei` to `io.github.kobakei`.\n\n### Basic usage\n\nCall `RateThisApp.onCreate(Context)` and `RateThisApp.showRateDialogIfNeeded(Context)` in your launcher activity's onCreate() method.\n\n```java\n@Override\nprotected void onCreate(Bundle savedInstanceState) {\n    super.onCreate(savedInstanceState);\n    setContentView(R.layout.activity_main);\n\n    // Monitor launch times and interval from installation\n    RateThisApp.onCreate(this);\n    // If the condition is satisfied, \"Rate this app\" dialog will be shown\n    RateThisApp.showRateDialogIfNeeded(this);\n}\n```\n\nThat's all! You can see \"Rate this app\" dialog at an appropriate timing.\n\n## Advanced usages\n\n### Custom condition\n\nIn default, the dialog will be shown when **any of** the following conditions is satisfied.\n\n* App is launched more than 10 times\n* App is launched more than 7 days later than installation.\n\nIf you want to use your own condition, please call `RateThisApp.init(Configuration)` in your Application or launcher activity onCreate method.\n\n```java\n// Custom condition: 3 days and 5 launches\nRateThisApp.Config config = new RateThisApp.Config(3, 5);\nRateThisApp.init(config);\n```\n\n### Custom strings\n\nYou can override title, message and button labels.\n\n```java\nRateThisApp.Config config = new RateThisApp.Config();\nconfig.setTitle(R.string.my_own_title);\nconfig.setMessage(R.string.my_own_message);\nconfig.setYesButtonText(R.string.my_own_rate);\nconfig.setNoButtonText(R.string.my_own_thanks);\nconfig.setCancelButtonText(R.string.my_own_cancel);\nRateThisApp.init(config);\n```\n\n### Custom url\n\nIn default, rate button navigates to the application page on Google Play. You can override this url as below.\n\n```java\nRateThisApp.Config config = new RateThisApp.Config();\nconfig.setUrl(\"http://www.example.com\");\nRateThisApp.init(config);\n```\n\n### Opt out from your code\n\nIf you want to stop showing the rate dialog, use this method in your code.\n\n```java\nRateThisApp.stopRateDialog(this);\n```\n\n### Callback\n\nYou can receive yes/no/cancel button click events.\n\n```java\nRateThisApp.setCallback(new RateThisApp.Callback() {\n    @Override\n    public void onYesClicked() {\n        Toast.makeText(MainActivity.this, \"Yes event\", Toast.LENGTH_SHORT).show();\n    }\n\n    @Override\n    public void onNoClicked() {\n        Toast.makeText(MainActivity.this, \"No event\", Toast.LENGTH_SHORT).show();\n    }\n\n    @Override\n    public void onCancelClicked() {\n        Toast.makeText(MainActivity.this, \"Cancel event\", Toast.LENGTH_SHORT).show();\n    }\n});\n```\n\n## Contribute this project\n\nIf you want to contribute this project, please send pull request.\nIn present, I need contributors who can translate resources from English/Japanese into other languages.\n\n## License\n\n```\nCopyright 2013-2017 Keisuke Kobayashi\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n\n## Author\n\nKeisuke Kobayashi - kobakei122@gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkobakei%2FAndroid-RateThisApp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkobakei%2FAndroid-RateThisApp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkobakei%2FAndroid-RateThisApp/lists"}