https://github.com/tuenti/smsradar

Android library created to listen incoming and outgoing SMS's
https://github.com/tuenti/smsradar

Last synced: about 4 hours ago
JSON representation

Android library created to listen incoming and outgoing SMS's

• Host: GitHub
• URL: https://github.com/tuenti/smsradar
• Owner: tuenti
• License: apache-2.0
• Created: 2014-05-27T17:44:51.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2021-10-11T14:49:04.000Z (about 3 years ago)
• Last Synced: 2024-04-16T12:00:52.754Z (7 months ago)
• Language: Java
• Size: 908 KB
• Stars: 388
• Watchers: 38
• Forks: 118
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
SMS Radar [![Build Status](https://travis-ci.org/tuenti/SmsRadar.svg?branch=master)](https://travis-ci.org/tuenti/SmsRadar) [![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.tuenti.smsradar/library/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.tuenti.smsradar/library) [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-SmsRadar-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/1328)

=========

Read incoming and outgoing text messages using an Android application across different Android SDK versions it's not

trivial. If yo don't want to appear as SMS application and your application has to read incoming and outgoing SMSs

this is your library.

This Android library offers you two main classes to use to start listening text messages. SMS Radar is implemented in

top of an Android service. To start / stop listening text messages use ``SmsRadar.initializeSmsRadarService(context,

listener)`` with a ``Context`` instance and a ``SmsListener`` implementation.

Each time the device owner receives one SMS the ``SmsListener`` used to initialize ``SmsRadarService`` service will be

notified in on ``onSmsSent(Sms sms)`` or ``onSmsReceived(Sms sms)`` methods.

The SMS information provided on ``SmsListener`` methods is:

* SMS address. MSISDN used to send/receive the SMS.

* SMS date. SMS local creation date.

* SMS content. Message sent in the SMS.

* SMS type. One SMS can be received or sent. Review ``SmsType`` enum if need it.

This library works on Android 2.X or higher versions.

Download

--------

Download the project, compile it using ```mvn clean install``` import ``smsradar-1.0.4.jar`` into your project.

Or declare it into your pom.xml

```xml

    com.tuenti.smsradar

    library

    1.0.4

```

Or into your build.gradle

```groovy

dependencies{

    compile 'com.tuenti.smsradar:library:1.0.4'

}

```

Usage

-----

Declare permissions to read SMS content provider in your AndroidManifest:

```xml

```

Declare SmsRadar service in your AndroidManifest:

```xml

```

To use SMS Radar library you only have to initialize ``SmsRadar`` using a Context instance and one ``SmsListener``:

```java

SmsRadar.initializeSmsRadarService(context, new SmsListener() {

			@Override

			public void onSmsSent(Sms sms) {

				showSmsToast(sms);

			}

			@Override

			public void onSmsReceived(Sms sms) {

				showSmsToast(sms);

			}

		});

```

You can stop the SMS observer like in this sample:

```java

SmsRadar.stopSmsRadarService(context);

```

Credits & Contact

-----------------

SmsRadar was created by [Android team at Tuenti Technologies S.L.](http://github.com/tuenti). You can follow Tuenti

engineering team on Twitter [@tuentieng](http://twitter.com/tuentieng).

License

-------

SmsRadar is available under the Apache License, Version 2.0. See LICENSE.txt file for more info.