{"id":13848787,"url":"https://github.com/frakbot/GlowPadBackport","last_synced_at":"2025-07-12T13:32:35.667Z","repository":{"id":6627293,"uuid":"7871138","full_name":"frakbot/GlowPadBackport","owner":"frakbot","description":"A backport of the Android 4.2 GlowPadView that works on the SDK on API levels 4+","archived":true,"fork":false,"pushed_at":"2015-11-24T13:46:00.000Z","size":243,"stargazers_count":246,"open_issues_count":1,"forks_count":87,"subscribers_count":24,"default_branch":"master","last_synced_at":"2024-07-01T10:56:09.711Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frakbot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-01-28T14:23:26.000Z","updated_at":"2024-02-12T18:14:36.000Z","dependencies_parsed_at":"2022-08-24T13:39:38.530Z","dependency_job_id":null,"html_url":"https://github.com/frakbot/GlowPadBackport","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frakbot%2FGlowPadBackport","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frakbot%2FGlowPadBackport/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frakbot%2FGlowPadBackport/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frakbot%2FGlowPadBackport/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frakbot","download_url":"https://codeload.github.com/frakbot/GlowPadBackport/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213949807,"owners_count":15661676,"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":[],"created_at":"2024-08-04T19:00:57.646Z","updated_at":"2024-08-04T19:03:22.949Z","avatar_url":"https://github.com/frakbot.png","language":"Java","funding_links":[],"categories":["Java","Libs"],"sub_categories":["\u003cA NAME=\"Widget\"\u003e\u003c/A\u003eWidget"],"readme":"GlowPadBackport [ ![Download](https://api.bintray.com/packages/frakbot/maven/GlowPadBackport/images/download.svg) ](https://bintray.com/frakbot/maven/GlowPadBackport/_latestVersion)\n===============\n\n**A backport of the Android 4.2 GlowPadView that works on the SDK on API levels 4+.**\n\nIt is heavily based upon Google's own internal implementation of the GlowPadView found in Android 4.2 Jelly Bean, but ported to be able to run on the Android SDK up from version 1.6 (API level 4, codename Donut). It uses Reflection in a couple of method calls to access some hidden APIs, so it might break on some Android version, or in the future. I tried limiting the usage of Reflection as much as possible, but those three methods did not have any alternatives.\n\nI'm releasing my own code under the same Apache 2.0 license the underlying Android code is licensed under. Android code is written by Google, and licensed under that same Apache 2.0 license.\n\n**GlowPadBackport** relies on [`NineOldAndroids`][2], an awesome backport of the Android 3+ Animation APIs made by [Jake Wharton][3].\n\n## Important note\nThis library will NOT do anything that is not strictly needed for this to build/work. Since this class has since been removed from AOSP, **this library should be considered DEPRECATED**. No efforts will be put into it, including merging PRs, for anything but very critical issues.\n\n## What is a GlowPad?\n\nThe `GlowPadView` is the view that Google uses in Android 4.1 and 4.2 (and, in a slightly different flavour, on Android 4.0 as well) on both the insecure lockscreen and the Incoming call Activity. It's the circular grid of dots, with a central handle that the user can grab to various customizable targets.\n\nGoogle decided to only provide a private implementation of that view in AOSP. It's not an SDK-facing view, it has lots of internal APIs references, and doesn't work in older versions of Android. What I have done is I have rewritten part of the code to work on Android SDK versions starting with Android 1.6 Donut, which is to mean it runs pretty much on any hardware out there.\n\nOf course performance is not going to be buttery smooth on older OS versions if the hardware is not up to it. Still, it can work decently even on underpowered hardware such as the [i'm Watch](http://www.imsmart.com/en/i-m-watch/overview) Android smartwatch (you have to decrease the points count multiplier to 3-4 from the default of 8 thou).\n\nI also exposed a couple more functions that aren't available on the AOSP internal version, such as the ability to change the points count. This means you can use the `GlowPadView` in any of your apps, and create custom Holo-like lockscreens for older versions of Android.\n\n\n## Usage\n\nIn order to use the `GlowPadView` in your project, follow these steps:\n\n  1. Ensure you have the proper repository configured in your `build.gradle` file, eg.:\n\n  ```groovy\n  repositories {\n    maven {\n      url \"http://dl.bintray.com/frakbot/maven\" \n    }\n  }\n  ```\n  \n  This has to be in your app module's `build.gradle` or in the project's top-level `build.gradle` file. Android Studio puts it into the top-level file by default.\n\n  2. Add the dependency to your app's module `build.gradle` file, eg.:\n\n  ```groovy\n  dependencies {\n      // Your other dependencies...\n      compile 'net.frakbot:glowpadbackport:2.1.1'\n  }\n  ```\n\n  3. Reference the GlowPadView in an XML layout (or initialise it from code)\n\n    ```xml\n    \u003cRelativeLayout xmlns:android=\"http://schemas.android.com/apk/res/android\"\n                    xmlns:app=\"http://schemas.android.com/apk/res-auto\"\n                    android:layout_width=\"fill_parent\"\n                    android:layout_height=\"fill_parent\"\u003e\n    \n        \u003cnet.frakbot.glowpadbackport.GlowPadView\n                android:id=\"@+id/incomingCallWidget\"\n                android:layout_width=\"fill_parent\"\n                android:layout_height=\"fill_parent\"\n                android:layout_marginTop=\"-10dp\"\n                android:layout_marginBottom=\"-46dp\"\n                android:background=\"@android:color/black\"\n                android:visibility=\"visible\"\n                android:gravity=\"top\"\n\n                app:targetDrawables=\"@array/incoming_call_widget_2way_targets\"\n                app:handleDrawable=\"@drawable/ic_in_call_touch_handle\"\n                app:innerRadius=\"@dimen/glowpadview_inner_radius\"\n                app:outerRadius=\"@dimen/glowpadview_target_placement_radius\"\n                app:outerRingDrawable=\"@drawable/ic_lockscreen_outerring\"\n                app:snapMargin=\"@dimen/glowpadview_snap_margin\"\n                app:vibrationDuration=\"20\"\n                app:feedbackCount=\"1\"\n                app:glowRadius=\"@dimen/glowpadview_glow_radius\"\n                app:pointDrawable=\"@drawable/ic_lockscreen_glowdot\"/\u003e\n\n    \u003c/RelativeLayout\u003e\n    ```\n\n  2. ????\n  3. Profit!\n\n\n## Sample app\n\nYou can find the `GlowPadSample` app in the [**Releases** section](https://github.com/frakbot/GlowPadBackport/releases/tag/v2.1.1) of this repo.\n\nThe app used to be available on the Play Store but has not been updated and has since been pulled.\n\n\n## Building from source\n\nClone the repository on your computer. The old IntelliJ IDEA and Eclipse-style projects have been\ndiscontinued, and the library has been moved to the new Gradle-based build system, and [Android Studio][1].\nYou can of course continue to use this library in IntelliJ IDEA, but you'll have to build it using Gradle.\n\nBefore being able to build the project, you will need to rename the `keystore.properties.example` and `local.properties.example`\nfiles in the repo root, removing the `.example` suffix. Please note that you _will_ need to provide valid values in\nboth files, in place of the placeholders, before being able to complete a build.\n\n\n## License\n\n    Copyright 2015 Frakbot (Sebastiano Poggi and Francesco Pontillo)\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\n\n   [1]: http://developer.android.com/sdk/installing/studio.html\n   [2]: http://www.nineoldandroids.com/\n   [3]: https://github.com/JakeWharton\n   [4]: http://play.google.com/store/apps/details?id=net.frakbot.glowpadbackportsample\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrakbot%2FGlowPadBackport","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrakbot%2FGlowPadBackport","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrakbot%2FGlowPadBackport/lists"}