{"id":19566146,"url":"https://github.com/deveryware/noteacons-android","last_synced_at":"2025-09-16T04:46:30.168Z","repository":{"id":76715822,"uuid":"67781037","full_name":"Deveryware/noteacons-android","owner":"Deveryware","description":null,"archived":false,"fork":false,"pushed_at":"2016-11-22T10:30:36.000Z","size":359,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-02-26T09:33:02.056Z","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/Deveryware.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-09T08:27:26.000Z","updated_at":"2016-11-25T11:49:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"7fd0cc11-278d-4dc0-97fc-ae91fd7280fb","html_url":"https://github.com/Deveryware/noteacons-android","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Deveryware/noteacons-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Deveryware%2Fnoteacons-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Deveryware%2Fnoteacons-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Deveryware%2Fnoteacons-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Deveryware%2Fnoteacons-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Deveryware","download_url":"https://codeload.github.com/Deveryware/noteacons-android/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Deveryware%2Fnoteacons-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275364612,"owners_count":25451514,"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","status":"online","status_checked_at":"2025-09-16T02:00:10.229Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-11-11T05:29:51.356Z","updated_at":"2025-09-16T04:46:30.147Z","avatar_url":"https://github.com/Deveryware.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"#Noteacons SDK\n\n[![Release](https://jitpack.io/v/org.bitbucket.deverywareiberia/sdk-android.svg)](https://jitpack.io/#org.bitbucket.deverywareiberia/sdk-android)\n\nWelcome to Noteacons! \n\nSimple, effective and potent proximity campaigns. \n\nIf you want to edit your campaigns, go to our [dashboard](http://panel.noteacons.com/) and use our [3 simple steps to launch guide](http://www.noteacons.com/support/) to get started.\n\n## Get the Demo App\n\nThere's a demo app in this repository, but you can also check out or live demo: [Noteacons Beacon Simulator](https://play.google.com/store/apps/details?id=com.noticoiberia.noteaconsapp)\n\n##Installation\n\nFollow these steps to integrate the Noteacons SDK within an existing project:\n\nAdd the JitPack repository in your root build.gradle at the end of repositories:\n\n```\nallprojects {\n    repositories {\n        maven { url \"https://jitpack.io\" }\n    }\n}\n```\n\nAdd the dependecy in your app build.gradle:\n\n```\n  dependencies {\n      compile 'org.bitbucket.deverywareiberia:sdk-android:v1.3.0'\n  }\n```\n\nThis version works with:\n\n* **Google Play Services 9.8.0** \n* **[Android Beacon Library 2.9.1](http://altbeacon.github.io/android-beacon-library/)**\n* **Android Support Library v4 25.0.0**\n\n##Integration\n\n###Manifest\n\nAdd your keys in the Manifest.xml file:\n\n```\n\u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n\u003cmanifest xmlns:android=\"http://schemas.android.com/apk/res/android\"\n    package=\"com.deveryware.noteaconsdemo\"\u003e\n\n    \u003capplication\u003e\n        \u003cmeta-data android:name=\"com.deveryware.noteacons.API_KEY\" android:value=\"YOUR_API_KEY\"/\u003e\n        \u003cmeta-data android:name=\"com.deveryware.noteacons.API_SECRET\" android:value=\"YOUR_API_SECRET\"/\u003e\n    \u003c/application\u003e\n\n\u003c/manifest\u003e\n```\n\n###Application\n\nIn your Application class, call the `initSDK` function: \n\n```\npublic class MyApplication extends Application {\n    private static final String TAG = \"MyApplication\";\n\n    @Override\n    public void onCreate() {\n        super.onCreate();\n        Noteacons.initSDK(this);\n    }\n}\n```\n\nDon't forget to add the application name in the manifest.xml file:\n\n```\n\u003cmanifest xmlns:android=\"http://schemas.android.com/apk/res/android\"\n    package=\"com.deveryware.noteaconsdemo\"\u003e\n    \u003capplication\n        android:name=\"com.deveryware.noteaconsdemo.MyApplication\"\n    \u003c/application\u003e\n\u003c/manifest\u003e\n```\n\n###Notification Icon\n\nYou need to specify an icon for the Noteacons SDK notifications. This icon must be in the mipmap folder or in the drawable folder and must be called `noteacons_icon`. If this icon doesn't exist, the SDK won't send notifications.\n\n###Permissions\n\nBeginning in Android 6.0 (API level 23), users grant permissions to apps while the app is running, not when they install the app. [More info] (http://developer.android.com/training/permissions/requesting.html). The Noteacon library requires the `ACCESS_FINE_LOCATION` permission. This permission is in the [dangerous permissions list] (http://developer.android.com/guide/topics/security/permissions.html#normal-dangerous) and you will need to request the permission at runtime:\n\n```\npublic class MainActivity extends AppCompatActivity {\n\n    private static final String TAG = \"MainActivity\";\n    private static final int PERMISSION_REQUEST_FINE_LOCATION = 1;\n\n    @Override\n    protected void onCreate(Bundle savedInstanceState) {\n        //...\n        askForPermissions();\n        //...\n    }\n\n    private void askForPermissions() {\n        if (Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.M) {\n            if (this.checkSelfPermission(Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {\n                requestPermissions(new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, PERMISSION_REQUEST_FINE_LOCATION);\n            }\n        }\n    }\n\n    @Override\n    public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults) {\n        switch (requestCode) {\n            case PERMISSION_REQUEST_FINE_LOCATION: {\n                if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {\n                    Log.d(TAG, \"Fine location permission granted\");\n                    Noteacons.fineLocationPermissionGranted();\n                } else {\n                    Log.w(TAG, \"Fine location permission not granted\");\n                }\n            }\n        }\n    }\n}\n```\n\nNote that, after the permission has been granted, you must call to the `Noteacons.fineLocationPermissionGranted()` method. [Here] (http://developer.android.com/training/permissions/best-practices.html) you have more info about permissions best practices.\n\n## Customization\n\nTo learn more about Noteacons check the [customization docs](http://noteacons-docs.readthedocs.io/en/latest/android/customization/).\n\n\n\n\n\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveryware%2Fnoteacons-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeveryware%2Fnoteacons-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveryware%2Fnoteacons-android/lists"}