Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/urbandroid-team/dont-kill-my-app
Android vendors, don't kill my app!
https://github.com/urbandroid-team/dont-kill-my-app
android dontkillmyapp vendors
Last synced: 29 days ago
JSON representation
Android vendors, don't kill my app!
- Host: GitHub
- URL: https://github.com/urbandroid-team/dont-kill-my-app
- Owner: urbandroid-team
- License: cc-by-4.0
- Created: 2018-12-19T04:42:37.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-08-19T17:38:46.000Z (3 months ago)
- Last Synced: 2024-10-02T01:42:33.584Z (about 1 month ago)
- Topics: android, dontkillmyapp, vendors
- Language: JavaScript
- Size: 44.9 MB
- Stars: 1,249
- Watchers: 108
- Forks: 2,610
- Open Issues: 403
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Android vendors, don't kill my app!
### [dontkillmyapp.com](https://dontkillmyapp.com)
## Licence
This project's source code is open but not intended to be copied in its entirety.
The content (compiled site), as it shows at www.dontkillmyapp.com, is licenced under CC-BY licence, and thus free to be shared, adapted, even commercially, under the condition of mentioning the original authors of the site, as either www.dontkillmyapp.com, or Urbandroid Team.
## API
The website provides a JSON API at https://dontkillmyapp.com/api/v1/output.json for developers to use on their websites or in their apps.
If you use the API, please let us know via e-mail at [email protected] and give credit to dontkillmyapp.com.
### API v1 docs
URL: https://dontkillmyapp.com/api/v1/output.json
API v1 outputs info on all vendors in one big JSON. If you want one JSON URL per vendor, see API v2.
scheme:
````
{ "vendors" :
[
{
"name": "Human-readable vendor name",
"manufacturer": ["name","alias1","alias2"],
"url": "/relative-url-to-vendor",
"award": number or null,
"position": number or null,
"explanation": "JSON-escaped HTML",
"user_solution": "JSON-escaped HTML",
"developer_solution": "JSON-escaped HTML"
},
{
...
},
{
...
}
]
}
````
### API v2 docs
URL: https://dontkillmyapp.com/api/v2/[vendor].json
example: [https://dontkillmyapp.com/api/v2/nokia.json](https://dontkillmyapp.com/api/v2/nokia.json)
API v2 provides one JSON URL per vendor.
scheme:
````
{
"name": "Human-readable vendor name",
"manufacturer": ["name","alias1","alias2"],
"url": "/relative-url-to-vendor",
"award": number or null,
"position": number or null,
"explanation": "JSON-escaped HTML",
"user_solution": "JSON-escaped HTML",
"developer_solution": "JSON-escaped HTML"
}
````
## Contribution
Pull requests are very welcome, as well as discussion using GitHub issues.
### Add a new vendor / edit existing vendor:
In _vendor folder, add or edit a xxxx.md file.
Template:
```
---
name: Nokia
layout: vendor
permalink: nokia
explanation: ''
user_solution: ''
developer_solution: ''
---
Y U say stock Android!?
```
### Award a vendor
Add
```
award: (int between 1 and 5)
```
variable to the vendor.md file you wish to award.
## Who started this project?
Ultimately, every indie Android developer is at least partly affected by this issue.
We at Urbandroid Team are affected heavily with our Sleep as Android app and we gathered so much info about hacks and workarounds that we felt the need to share the info. We started by contacting individual indie developers with offers to exchange info, which led to the idea of a more effective approach in the form of a libre software website.