# Android-Cling

**Repository Path**: ekber/Android-Cling

## Basic Information

- **Project Name**: Android-Cling
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-12-11
- **Last Updated**: 2024-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Android-Cling

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-Android--Cling-green.svg?style=true)](https://android-arsenal.com/details/1/3720)
[![Download](https://api.bintray.com/packages/majeurandroid/maven/cling/images/download.svg) ](https://bintray.com/majeurandroid/maven/cling/_latestVersion)
![Maven](https://img.shields.io/badge/Maven-jcenter-green.svg)

Example of use is available in [Solid Launcher](https://play.google.com/store/apps/details?id=com.majeur.launcher)

<img src="https://raw.githubusercontent.com/MajeurAndroid/Android-Cling/master/web_art/device_example.png" height="800">

## What is Cling library
Cling is a library that allows you to create overlays that will allow the user to be informed of how your application works.

There is already a bunch of libraries to do that, but I wanted a simple and light library that do this quickly, simply and fastly. And also without creating a Bitmap of the size of the screen !

You can display one unique overlay or sequence of overlays. Overlays are represented by Cling objects.
Clings point to a Target, if Target isn't Target.NONE, the overlay will have a hole just on the provided Target. This allows user to focus on the ui element you want to describe.

## How to use Cling library
### Dependency
Add to your **project**'s build.gradle file:

    repositories {
        ...
		jcenter()
		...
	}
Add to your **module**'s build.gradle file:

	dependencies {
	    ...
		compile 'com.majeur.cling:cling:1.1'
	    ...
	}

### Implementation
Clings are managed through ClingManager class.
```java

    private SharedPreferences mSharedPreferences;
    private ClingManager mClingManager;

    @Override
    protected void onResume() {
        super.onResume();

        if (mSharedPreferences.getBoolean(START_TUTORIAL_KEY, true)
                && (mClingManager == null || !mClingManager.isStarted()))

        mClingManager = new ClingManager(this);

        // When no Target is set, Target.NONE is used
        mClingManager.addCling(new Cling.Builder(this)
                .setTitle("Welcome to this app")
                .setContent("This application is meant to be the best app you will ever try on android.")
                .build());

        mClingManager.addCling(new Cling.Builder(this)
                .setTitle(R.string.drawer_tutorial_title)
                .setContent(R.string.drawer_tutorial_message)
                .setMessageBackground(getResources().getColor(R.color.teal))
                .setTarget(new ViewTarget(this, R.id.drawer))
                .build());

        mClingManager.addCling(new Cling.Builder(this)
                .setTitle("Here is another feature")
                .setTitleTextAppearance(R.style.textAppearanceTitleNice)
                .setContent("Look how amazing this feature is, blablabla blablabla bla bla.")
                .setContentTextAppearance(R.style.textAppearanceContentNice)
                .setTarget(new ViewTarget(mFeatureView))
                .setClingColor(getColor(R.color.cling))
                .setMessageBackground(getColor(R.color.red))
                .build());

        mClingManager.setCallbacks(new ClingManager.Callbacks() {
            @Override
            public boolean onClingClick(int position) {
                // We return false to tell to cling manager that we didn't handle this,
                // so it can perform the default action (ie. showing the next Cling).
                // This is the default value returned by super.onClingClick(position), so
                // in a real project, we would just leave this method unoverriden.
                return false;
            }

            @Override
            public void onClingShow(int position) {
                Toast.makeText(MyActivity.this, "Cling #" + position + " is shown", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onClingHide(int position) {
                Toast.makeText(MyActivity.this, "Cling #" + position + " is hidden", Toast.LENGTH_SHORT).show();

                // Last Cling has been shown, tutorial is ended.
                if (position == 2) {
                    mSharedPreferences.edit()
                            .putBoolean(START_TUTORIAL_KEY, false)
                            .apply();

                    mClingManager = null;
                }
            }
        });

        mClingManager.start();
    }
```

##License

	 Copyright 2016 MajeurAndroid

	 Licensed under the Apache License, Version 2.0 (the "License");
	 you may not use this file except in compliance with the License.
	 You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

	 Unless required by applicable law or agreed to in writing, software
	 distributed under the License is distributed on an "AS IS" BASIS,
	 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	 See the License for the specific language governing permissions and
	 limitations under the License.