ContentProvider

• 앱과 앱 간의 데이터 연동을 목적으로 하는 컴포넌트

• ContentProvider를 상속받아서 작성

• AndroidManifest.xml 파일에 등록 (컴포넌트는 등록 필수)
• 필수 속성: name, authorities

• 컨텐츠 프로바이더는 인텐트를 발생시키지 않으며, 필요한 순간에 시스템에서 자동을 생성한다.
• 컨텐츠 프로바이더를 사용하는 앱은 query(), insert(), delete(), update() 함수만 호출

• 외부 앱의 컨텐츠 프로바이더를 이용하려면, 해당 앱을 이용하기 위한 Query Visibility 관련 설정을 해줘야 한다.
• 컨텐츠 프로바이더를 갖고 있는 앱의 패키지명을 태그로, 혹은 컨텐츠 프로바이더의 authorities 문자열을 태그로 선언

• 시스템의 컨텐츠 프로바이더를 사용하기 위한 객체가 ContentResolver 객체
• ContentResolver 객체는 contentResolver 프로퍼티로 획득하여 query(), insert(), delete(), update() 함수를 호출

• 컨텐츠 프로바이더를 식별하기 위한 Uri 객체

---

주소록 앱

주소록 앱을 연동하여 주소록 목록 화면 (액티비티)을 띄우고, 유저가 선택한 사람의 전화번호 혹은 이메일 정보를 얻어보자! (컨텐츠 프로바이더)

퍼미션 부여 (매니페스트 파일)

<uses-permission android:name="android.permission.READ_CONTACTS"/>

주소록의 목록 화면 띄우기

• ContentsContract.Contacts.CONTENT_URI : 모든 사람 출력
• ContentsContract.CommonDataKinds.Phone.CONTENT_URI : 전화번호가 있는 사람만 출력
• ContentsContract.CommonDataKinds.Email.CONTENT_URI : 이메일이 있는 사람만 출력

val intent = Intent(Intent.ACTION_PICK, ContentsContract.CommonDataKinds.Phone.CONTENT_URI) 
requestActivity(intent) // 암시적 인텐트 전달 

• 주소록으로부터 전달 받은 결과는 URL 문자열 형태이며, URL의 맨 마지막 단어가 유저가 선택한 사람의 식별자 값이 된다.
• 이 식별자 값을 컨텐츠 프로바이더에게 제공하면, 원하는 데이터를 추출할 수 있다.

실습 예제

<uses-permission android:name="android.permission.READ_CONTACTS"/>

package com.tutorial.c63

import android.content.Intent
import android.content.pm.PackageManager
import android.os.Bundle
import android.provider.ContactsContract
import android.widget.Button
import android.widget.TextView
import android.widget.Toast
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AppCompatActivity
import androidx.core.content.ContextCompat

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val button = findViewById<Button>(R.id.button)
        val resultView = findViewById<TextView>(R.id.resultView)

        // 다른 액티비티로부터 결과 값을 받는 경우 -> StartActivityForResult
        val requestActivity = registerForActivityResult(
            ActivityResultContracts.StartActivityForResult()
        ) {
        	// 컨텐츠 프로파이더에게 데이터 요청 
            val cursor = contentResolver.query(
                it.data!!.data!!, // 유저가 선택한 항목의 식별자 값 (uri)
                arrayOf(
                    ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME, // 이름
                    ContactsContract.CommonDataKinds.Phone.NUMBER // 전화번호
                ),
                null,
                null,
                null
            )

            var name = "none"
            var phone = "none"
            if (cursor!!.moveToFirst()) {
                name = cursor.getString(0)
                phone = cursor.getString(1)
            }

            // 이름과 전화번호를 텍스트뷰에 보여주기
            resultView.text = "result: name - ${name}, phone - ${phone}"
        }

        // 주소록에 대한 퍼미션 요청
        val permissionLauncher = registerForActivityResult(
            ActivityResultContracts.RequestPermission()
        ) { isGranted ->
            if (isGranted) { // 퍼미션이 허용되면
                // 주소록 목록 화면으로 넘어가기
                val intent = Intent(
                    Intent.ACTION_PICK,
                    ContactsContract.CommonDataKinds.Phone.CONTENT_URI // 전화번호가 있는 사람만 출력 
                )
                requestActivity.launch(intent)
            } else {
                Toast.makeText(this, "permission denied", Toast.LENGTH_SHORT).show()
            }
        }

        button.setOnClickListener {
            // 주소록 퍼미션 허용 여부 확인
            val status = ContextCompat.checkSelfPermission(this,
                "android.permission.READ_CONTACTS")
            if(status == PackageManager.PERMISSION_GRANTED){
                // 주소록 목록 화면으로 넘어가기
                val intent = Intent(Intent.ACTION_PICK,
                    ContactsContract.CommonDataKinds.Phone.CONTENT_URI)
                requestActivity.launch(intent)
            }else{
                permissionLauncher.launch("android.permission.READ_CONTACTS")
            }
        }
    }
}

---

갤러리 앱

• 암시적 인텐트로 갤러리 앱의 이미지 목록 화면을 출력해보자!

val intent = Intent(Intent.ACTION_PICK, MediaStore.Images.Media.EXTERNAL_CONTENT_URI)
intent.type = "image/*"
requestActivity.launch(intent) 

• 이미지 파일의 크기가 너무 크면 OOM (OutOfMemory Exception)이 발생할 수 있다.
• 따라서, BitmapFactory.Options 객체의 inSampleSize 값으로 데이터 사이즈를 줄여서 로딩해야 한다.

val option = BitmapFactory.Options() 
option.inSampleSize = 5 

• 갤러리 앱의 ContentProvider가 제공하는 InputStream 객체 획득
• InputStream 객체에 넘어오는 데이터를 이용하여 비트맵 객체 생성

var inputStream = contentResolver.openInputStream(it.data!!.data!!)
val bitmap = BitmapFactory.decodeStream(inputStream, null, option) 

실습 예제

package com.tutorial.c64

import android.content.Intent
import android.graphics.BitmapFactory
import android.os.Bundle
import android.provider.MediaStore
import android.widget.Button
import android.widget.ImageView
import android.widget.Toast
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val imageView = findViewById<ImageView>(R.id.image_view)
        val button = findViewById<Button>(R.id.button)

        val launcher = registerForActivityResult(
            ActivityResultContracts.StartActivityForResult()
        ) {
            try {
                val option = BitmapFactory.Options()
                option.inSampleSize = 5

                // 컨텐츠 프로바이더에게 제공받은 식별자 값으로 비트맵 객체 생성
                val inputStream = contentResolver.openInputStream(it.data!!.data!!)
                val bitmap = BitmapFactory.decodeStream(inputStream, null, option)
                inputStream!!.close()

                bitmap?.let {
                    imageView.setImageBitmap(bitmap) // 이미지 설정
                } ?: let {
                    Toast.makeText(this, "이미지 로딩 실패", Toast.LENGTH_SHORT).show()
                }
            } catch (e: Exception) {
                e.printStackTrace()
            }
        }

        button.setOnClickListener {
            val intent = Intent(Intent.ACTION_PICK, MediaStore.Images.Media.EXTERNAL_CONTENT_URI)
            intent.type = "image/*"
            launcher.launch(intent) // 암시적 인텐트로 갤러리 앱 띄우기
        }
    }
}

---

전화 앱

• 암시적 인텐트의 액션 문자열을 Intent.ACTION_CALL로 지정
• 암시적 인텐트의 data 인자 URL은 tel:로 선언, 그 뒤에 전화번호 명시

실습 예제

<uses-permission android:name="android.permission.CALL_PHONE"/>

package com.tutorial.c65

import android.content.Intent
import android.content.pm.PackageManager
import android.net.Uri
import android.os.Bundle
import android.widget.Button
import android.widget.EditText
import android.widget.Toast
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AppCompatActivity
import androidx.core.content.ContextCompat

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val editView = findViewById<EditText>(R.id.editView)
        val button = findViewById<Button>(R.id.button)

        val permissionLauncher = registerForActivityResult(
            ActivityResultContracts.RequestPermission()
        ){ isGranted ->
            if(isGranted){
                val intent = Intent(Intent.ACTION_CALL,
                    Uri.parse("tel:${editView.text}"))
                startActivity(intent) // 암시적 인텐트로 전화 앱 띄우기 
            }else{
                Toast.makeText(this, "denied", Toast.LENGTH_SHORT).show()
            }
        }

        button.setOnClickListener {
            val status = ContextCompat.checkSelfPermission(this,
            "android.permission.CALL_PHONE")
            if(status == PackageManager.PERMISSION_GRANTED){
                val intent = Intent(Intent.ACTION_CALL,
                    Uri.parse("tel:${editView.text}"))
                startActivity(intent)
            }else{ // 퍼미션 재요청 
                permissionLauncher.launch("android.permission.CALL_PHONE")
            }
        }
    }
}

---

카메라 앱

카메라 앱을 연동하여 사진을 촬영하고 결과를 돌려받는 방법에는 2가지가 있다.

• 사진 데이터 획득 방법
• 파일 공유 방법

사진 데이터 획득 방법

• 촬영한 사진을 파일로 저장하지 않는다.
• 넘겨받는 이미지 데이터의 크기가 작다.

val intent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
requestActivity.launch(intent)

val bitmap = it.data?.getExtras()?.get("data") as Bitmap 

파일 공유 방법

• 앱에서 사진을 저장할 파일을 만든다.
• 파일 정보를 포함하여 암시적 인텐트를 발생시켜 카메라 앱을 실행한다.
• 카메라 앱에서 사진 촬영 후, 촬영된 이미지를 공유된 파일에 저장한다.
• 카메라 앱이 종료되면서 성공/실패 여부를 반환한다.
• 앱에서 파일을 읽어 카메라 앱이 저장한 사진 데이터를 사용한다.

FileProvider

• 앱과 앱 간에 파일을 공유할 때는 FileProvider가 사용된다.
• 이를 위해서 공유하고자 하는 파일의 Uri 값을 준비해야 한다.
• res/xml/file_paths.xml 파일에 해당 내용 등록

• 매니페스트 파일에서 provider의 메타 데이터로 file_paths.xml 정보 등록

• 촬영된 이미지를 저장하기 위한 파일 생성

• 이미지 파일 공유를 위해 Uri 객체 생성 후, 해당 정보를 인텐트의 부가 데이터로 설정

• 파일 경로를 decodeFile() 함수에 지정하여 Bitmap 객체 획득

val bitmap = BitmapFactory.decodeFile(filePath, option)

실습 예제

res/xml/file_path.xml

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-path
        name="myfiles"
        path="Android/data/com.tutorial.c66/files/Pictures"/>
</paths>

매니페스트 파일에 FileProvider 등록

• 메타 데이터에 file_path.xml 정보 등록

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.tutorial.c66">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.AndroidLab">

        <provider
            android:authorities="com.tutorial.c66.fileprovider"
            android:name="androidx.core.content.FileProvider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_path"/>
        </provider>

        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:orientation="vertical"
    tools:context=".MainActivity">

    <androidx.cardview.widget.CardView
        android:layout_width="150dp"
        android:layout_height="150dp"
        app:cardCornerRadius="75dp"
        app:cardElevation="5dp">

        <ImageView
            android:id="@+id/imageView"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:scaleType="centerCrop" />
    </androidx.cardview.widget.CardView>

    <Button
        android:id="@+id/dataButton"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="24dp"
        android:text="data" />

    <Button
        android:id="@+id/fileButton"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="24dp"
        android:text="file" />

</LinearLayout>

MainActivity

package com.tutorial.c66

import android.content.Intent
import android.graphics.Bitmap
import android.graphics.BitmapFactory
import android.os.Bundle
import android.os.Environment
import android.provider.MediaStore
import android.widget.Button
import android.widget.ImageView
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AppCompatActivity
import androidx.core.content.FileProvider
import java.io.File
import java.text.SimpleDateFormat
import java.util.*

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val imageView = findViewById<ImageView>(R.id.imageView)
        val dataButton = findViewById<Button>(R.id.dataButton)
        val fileButton = findViewById<Button>(R.id.fileButton)

        val launcher = registerForActivityResult(
            ActivityResultContracts.StartActivityForResult()
        ){
            // 부가 데이터로부터 비트맵 객체 획득
            val bitmap = it.data?.extras?.get("data") as Bitmap
            bitmap.let{
                imageView.setImageBitmap(bitmap)
            }
        }

        dataButton.setOnClickListener {
            val intent = Intent(MediaStore.ACTION_IMAGE_CAPTURE) // 이미지 캡쳐 액션
            launcher.launch(intent) // 암시적 인텐트로 카메라 앱 띄우기
        }

        var filePath = ""
        val fileLauncher = registerForActivityResult(
            ActivityResultContracts.StartActivityForResult()
        ){
            // 이미지 파일로부터 비트맵 객체 생성
            val option = BitmapFactory.Options()
            option.inSampleSize = 3
            val bitmap = BitmapFactory.decodeFile(filePath, option)
            bitmap?.let {
                imageView.setImageBitmap(bitmap)
            }
        }

        fileButton.setOnClickListener {
            val timeStamp = SimpleDateFormat("yyyyMMdd_HHmmss").format(Date())
            val storageDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES)
            val file = File.createTempFile(
                "JPEG_${timeStamp}_",
                ".jpg",
                storageDir
            )
            filePath = file.absolutePath // 파일 경로명 설정
            val uri = FileProvider.getUriForFile(
                this,
                "com.tutorial.c66.fileprovider",
                file
            )

            // 암시적 인텐트의 부가 데이터로 파일 uri 등록하고 카메라 앱 띄우기
            val intent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
            intent.putExtra(MediaStore.EXTRA_OUTPUT, uri)
            fileLauncher.launch(intent)
        }
    }
}