---
description: CashButton Channeling Android SDK For "SK Planet"
---

# 시작하기

## 요구사항

{% hint style="info" %}
**연동 가이드는 CashButton Android SDK 최신 버전을 기준으로 작성되었습니다.**

안정적인 광고 플랫폼 및 개선된 수익화 기능의 탑재와 Android OS와의 호환성을 위해 최신 버전으로 업데이트하는 것을 권장합니다.
{% endhint %}

* **minSdkVersion -> 21 (LOLLIPOP)**
* **Android Studio -> 3.2 이상**
* **Android gradle plugin -> 4.0.1 이상**
* **Google Play 타겟 API 수준**
  * **2.1.0.0 ->  Android 14(compileSdkVersion 34)**
  * 2.0.0.X  -> Android 13(compileSdkVersion 33)
* **Kotlin version 1.6.20**
* [**Support AndroidX**](https://developer.android.com/topic/libraries/support-library?hl=ko)

***

## 연동키 확인

{% hint style="info" %}
**CashButton Android SDK는 연동하려는 앱의 고유 식별자가(AppId/AppSecret) 필요합니다.**

* **AppID**: CashButton Android SDK를 연동하는 앱별로 부여하는 고유 식별자입니다.
* **AppSecret**: CashButton Android SDK를 연동하는 앱별로 부여하는 고유 식별자의 값을 검증하는 고유값입니다.
{% endhint %}

{% hint style="warning" %}
**앱의 고유 식별자가 변경시 테스트중인 앱을 삭제하거나, 내부 데이터를 모두 지우고 테스트를 진행해 주세요.**

연동키의 정보는 담당 영업팀 또는 개발팀에 문의 부탁 드립니다.
{% endhint %}

***

## 원격 저장소(Repository) 설정

{% hint style="info" %}
프로젝트 수준의 “**build.gradle**” 또는 “**Setting.gradle**” 구성에 다음 저장소를 추가 합니다.
{% endhint %}

```groovy
// build.gradle 사용시
allprojects {
  repositories {
    google()
    mavenCentral()
    maven { url "https://jitpack.io" }
    maven { url 'https://dl.buzzvil.com/public/maven' }
    maven { url 'https://artifact.bytedance.com/repository/pangle' }
    maven { url 'https://devrepo.kakao.com/nexus/content/groups/public/' }
    maven { url 'https://raw.githubusercontent.com/coupang-ads-sdk/android/main' }
    maven { 
      url "https://dl.cloudsmith.io/public/avatye/Android-CashButton-SKP/maven/" 
    }
    maven {
      url "s3://repo.cauly.net/releases"
      credentials(AwsCredentials) {
        accessKey "AKIAWRZUK5MFKYVSUOLB"
        secretKey "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"
      }
    }
  }
}


// settings.gradle 사용시 (Android Studio Bumblebee or AGP 7.1.0~)
pluginManagement {
  repositories {
    gradlePluginPortal()
    google()
    mavenCentral()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
    maven { url "https://jitpack.io" }
    maven { url 'https://dl.buzzvil.com/public/maven' }
    maven { url 'https://artifact.bytedance.com/repository/pangle' }
    maven { url 'https://devrepo.kakao.com/nexus/content/groups/public/' }
    maven { url 'https://raw.githubusercontent.com/coupang-ads-sdk/android/main' }
    maven { 
      url "https://dl.cloudsmith.io/public/avatye/Android-CashButton-SKP/maven/" 
    }
    maven {
      url "s3://repo.cauly.net/releases"
      credentials(AwsCredentials) {
        accessKey "AKIAWRZUK5MFKYVSUOLB"
        secretKey "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"
      }
    }
  }
}
```

***

## SDK 의존성(dependency)

{% hint style="info" %}
캐시버튼 SDK의 의존성을 **앱(모듈) 수준의 "build.gradle"** 파일에 설정하세요.

***

```groovy
com.avatye.cashbutton.skp:product-button:2.1.5
```
{% endhint %}

```groovy
dependencies {
    // 캐시버튼 적용
    implementation 'com.avatye.cashbutton.skp:product-button:{버전정보}'
 }
```

***

## 퍼미션 설정(AndroidManifest.xml)

```xml
<!-- permission -->
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```



