• UIKit
  • SDK
  • 서버 API
Chat/
SDK/
Android/
SDK
  • Chat SDK 설치
  • Chat SDK 초기화
  • 로그인 및 로그아웃
  • 메시지
    • 개요
    • 메시지 보내기
    • 메시지 받기
    • 메시지 검색
    • 메시지 전달
    • 메시지 수정
    • 삽입 메시지
    • 메시지 삭제
    • 과거 메시지 비우기
    • 메시지 철회
    • 온라인 메시지 보내기
    • 메시지 읽음 확인
    • 메시지 조회
    • 알림
    • 지향적 그룹 메시지
    • 알림 차단
    • Key-Value 확장
    • 반응
    • 번역
    • 메시지 최상단 고정
  • 대화
    • 개요
    • 대화 목록
    • 대화 획득
    • 읽지 않은 메시지 수
    • 대화 최상단 고정
    • 대화 삭제
    • 초안
    • 마크
    • 대화 그룹
  • 그룹
    • 개요
    • 그룹 관리
    • 정보
    • 멤버 관리
    • 멤버 정보
    • 속성
    • 카운터
  • 커뮤니티 및 화제
    • 커뮤니티 관리
    • 권한 그룹
  • 사용자
    • 사용자 정보
    • 사용자 상태
    • 친구 관리
    • 친구 그룹화
    • 블록리스트
    • Follow
  • 국부 검색
    • 메시지 검색
    • 친구 검색
    • 그룹 검색
    • 그룹 멤버 검색
  • 시그널링
  • 인터페이스 참고 문서
    • Java
  • Guideline for Beginners
  • 콘솔 안내
    • 애플리케이션 생성 및 업그레이드
    • 기본 구성
    • 기능 구성
    • 계정 관리
    • 그룹 관리
    • 콜백 구성
  • 제품 소개
    • 메시지 관리
      • 1대1 메시지
      • 메시지 저장
      • 오프라인 푸시
      • 그룹 메시지
      • 메시지 포맷
    • 계정 시스템
      • 로그인 인증
      • 온라인 상태 관리
    • 그룹 관련
      • 그룹 시스템
      • 그룹 관리
    • 사용자 정보 및 관계망
      • 정보 관리
      • 관계망 관리
  • 구매 가이드
    • 과금 개요
    • 가격
  • 에러코드

Chat SDK 설치

본문은 Tencent Cloud IM SDK를 Android 프로젝트에 빠르게 통합하는 방법을 설명합니다.

개발 환경 요구사항

JDK 1.6.
Android 4.1(SDK API 16) 및 이후 버전 시스템.

SDK 통합(aar)

Gradle 자동 로딩 방식을 사용하거나 수동으로 aar을 다운로드한 후, 귀하의 현재 프로그래밍 프로젝트에 가져옵니다.

방법1: 자동 로딩(aar)

Maven Central 리포지토리에 게시된 IM SDK를 업데이트를 자동으로 다운로드하도록 gradle을 구성할 수 있습니다. Android Studio를 사용하여 프로젝트를 열고 app/build.gradle 파일을 간단한 3단계로 수정하여 아래와 같이 SDK를 프로젝트에 통합합니다.

1단계: SDK 종속성 추가

1. app의 build.gradle을 찾아 repositories에 mavenCentral() 종속성을 추가합니다.
repositories {
google()
jcenter()
// mavenCentral 리포지토리를 추가합니다
mavenCentral()
}
2. dependencies에 IM SDK 종속성을 추가합니다.
IM SDK 기본 버전을 사용하는 경우 다음 종속성을 추가합니다.
dependencies{
api 'com.tencent.imsdk:imsdk:버전 번호'
}
IM SDK 인핸스드 버전을 사용하는 경우 다음 종속성을 추가합니다.
dependencies{
api 'com.tencent.imsdk:imsdk-plus:버전 번호'
}
Pro IM SDK 인핸스드 버전을 사용하는 경우 다음 종속성을 추가합니다.
dependencies{
api 'com.tencent.imsdk:imsdk-plus-pro:버전 번호'
}
설명:
‘버전 번호’를 SDK의 실제 버전 번호로 바꿉니다. 최신 버전을 사용하는 것이 좋습니다. 버전 번호 5.4.666을 예로 들어 보겠습니다.
dependencies{
api 'com.tencent.imsdk:imsdk-plus:5.4.666'
}
>

#### 2단계: App 아키텍처 지정
defaultConfig에서 App이 사용하는 CPU 아키텍처를 지정합니다(armeabi-v7a, arm64-v8a, x86 및 x86_64는 IM SDK v4.3.118부터 지원됨).
defaultConfig { ndk { abiFilters "arm64-v8a" } }

#### 3단계: SDK 동기화
동기화 아이콘을 클릭합니다. jcenter에 대한 연결이 정상이면 SDK가 자동으로 다운로드되어 프로젝트에 통합됩니다.
![](https://main.qcloudimg.com/raw/99c145e1bfdc78b1af5c6fb8cebde90b.png)


### 방법2: 수동 다운로드(aar)
jcenter에 액세스할 수 없는 경우 SDK를 수동으로 다운로드하여 프로젝트에 통합할 수 있습니다.
#### 1단계: IM SDK 다운로드
GitHub에서 최신 버전의 [IM SDK](https://github.com/tencentyun/TIMSDK/tree/master/Android/IMSDK)를 다운로드합니다.

#### 2단계: IM SDK를 프로젝트 디렉터리에 복사
다운로드한 aar 파일을 app 프로젝트의 **/libs** 디렉터리에 복사합니다.
![](https://main.qcloudimg.com/raw/4175f483d55c2f99b99c993ada8dd5a0.png)

#### 3단계: App에서 사용하는 아키텍처 지정 및 아키텍처 컴파일 및 실행
app/build.gradle의 defaultConfig에서 App에서 사용하는 CPU 아키텍처를 지정합니다(armeabi-v7a, arm64-v8a, x86 및 x86_64는 IM SDK v4.3.118부터 지원됨).
defaultConfig { ndk { abiFilters "arm64-v8a" } }


## SDK 통합
aar 라이브러리를 통합하지 않으려면 jar 및 so 라이브러리 가져와서 IM SDK를 통합할 수 있습니다.

#### 1단계: IM SDK 다운로드 및 압축 해제
GitHub에서 aar 파일의 최신 버전을 [다운로드](https://github.com/tencentyun/TIMSDK/tree/master/Android/IMSDK)하고 압축을 해제합니다. 추출된 폴더에는 jar 파일과 so 서브 폴더가 포함되어 있습니다. **classes.jar**의 이름을 **imsdk.jar**로 바꿉니다.
![](https://main.qcloudimg.com/raw/ecc6ae484565b0170c42698825951eba.png)

#### 2단계: SDK 파일을 프로젝트 디렉터리에 복사
이름이 바뀐 jar 파일과 다른 아키텍처의 so 파일을 Android Studio의 기본 로딩 디렉터리에 복사합니다.
![](https://main.qcloudimg.com/raw/237b44da2ec04ba87a6cef66aa0b5321.png)

#### 3단계: App에서 사용하는 아키텍처 지정 및 아키텍처 컴파일 및 실행
app/build.gradle의 defaultConfig에서 App에서 사용하는 CPU 아키텍처를 지정합니다(armeabi-v7a, arm64-v8a, x86 및 x86_64는 IM SDK v4.3.118부터 지원됨).
defaultConfig { ndk { abiFilters "arm64-v8a" } }

## 앱 권한 설정
AndroidManifest.xml에서 App 권한을 설정합니다. IM SDK는 다음 권한 허용이 필요합니다.

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

## 난독화 정책 설정
proguard-rules.pro 파일에서 IM SDK 클래스를 난독화 금지 목록에 추가합니다.

-keep class com.tencent.imsdk.** { *; }