참여 기록 SDK (Android)

<activity
    android:name="dev.firstguest.FirstGuestPairActivity"
    android:exported="true"
    android:theme="@android:style/Theme.Translucent.NoTitleBar">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="firstguest" android:host="pair" />
    </intent-filter>
</activity>

override fun onResume() {
    super.onResume()
    dev.firstguest.FirstGuest.ping(this)
}

// First Guest 참여 기록 SDK (Android, 파일 하나 · 외부 라이브러리 없음)
//
// 하는 일: 테스터가 First Guest 사이트에서 "앱과 연결하기"를 누르면 이 앱이 열리며 연결 토큰을 저장한다.
// 그 뒤 앱이 열릴 때 하루 한 번 {token, package, versionCode} 만 보낸다. 기기 ID·광고 ID·위치는 보내지 않는다.
// 연결하지 않은 사용자(일반 사용자)에게는 아무것도 보내지 않는다.
//
// 설치
// 1) 이 파일을 app/src/main/java/dev/firstguest/ 에 넣는다 (package 이름은 그대로 둔다).
// 2) AndroidManifest.xml <application> 안에 추가:
//
//    <activity
//        android:name="dev.firstguest.FirstGuestPairActivity"
//        android:exported="true"
//        android:theme="@android:style/Theme.Translucent.NoTitleBar">
//        <intent-filter>
//            <action android:name="android.intent.action.VIEW" />
//            <category android:name="android.intent.category.DEFAULT" />
//            <category android:name="android.intent.category.BROWSABLE" />
//            <data android:scheme="firstguest" android:host="pair" />
//        </intent-filter>
//    </activity>
//
//    인터넷 권한이 없다면: <uses-permission android:name="android.permission.INTERNET" />
// 3) 첫 화면 Activity 의 onResume() 에서 FirstGuest.ping(this) 를 부른다.
// 4) 프로덕션 출시 전에 빼도 되고, 남겨 두어도 연결된 테스터만 보낸다.
//    Play Console "데이터 보안"에는 '앱 활동(앱 상호작용)'을 '앱 기능' 목적으로 수집한다고 신고한다.

package dev.firstguest

import android.app.Activity
import android.content.Context
import android.os.Bundle
import android.widget.Toast
import java.net.HttpURLConnection
import java.net.URL
import java.text.SimpleDateFormat
import java.util.Date
import java.util.Locale
import java.util.TimeZone

object FirstGuest {
    private const val PREFS = "first_guest"
    private const val DEFAULT_SERVER = "https://firstguest.vercel.app"

    internal fun save(context: Context, token: String, server: String?) {
        context.getSharedPreferences(PREFS, Context.MODE_PRIVATE).edit()
            .putString("token", token)
            .putString("server", server?.takeIf { it.startsWith("https://") } ?: DEFAULT_SERVER)
            .remove("last")
            .apply()
    }

    /** 앱이 열릴 때 부른다. 연결된 테스터만, KST 하루에 한 번 보낸다. */
    @JvmStatic
    fun ping(context: Context) {
        val app = context.applicationContext
        val prefs = app.getSharedPreferences(PREFS, Context.MODE_PRIVATE)
        val token = prefs.getString("token", null) ?: return
        val server = prefs.getString("server", DEFAULT_SERVER) ?: DEFAULT_SERVER
        val today = SimpleDateFormat("yyyy-MM-dd", Locale.US).apply { timeZone = TimeZone.getTimeZone("Asia/Seoul") }.format(Date())
        if (prefs.getString("last", null) == today) return

        @Suppress("DEPRECATION")
        val versionCode = try {
            app.packageManager.getPackageInfo(app.packageName, 0).versionCode
        } catch (e: Exception) { 0 }

        Thread {
            try {
                val conn = URL("$server/api/v1/ping").openConnection() as HttpURLConnection
                conn.requestMethod = "POST"
                conn.connectTimeout = 8000
                conn.readTimeout = 8000
                conn.doOutput = true
                conn.setRequestProperty("Content-Type", "application/json")
                val body = """{"token":"${token.replace("\"", "")}","package":"${app.packageName}","versionCode":$versionCode}"""
                conn.outputStream.use { it.write(body.toByteArray()) }
                val code = conn.responseCode
                if (code == 200) prefs.edit().putString("last", today).apply()
                // 404(토큰 없음)·409(테스트 끝남)면 더 보내지 않는다.
                if (code == 404 || code == 409) prefs.edit().remove("token").apply()
                conn.disconnect()
            } catch (_: Exception) {
                // 네트워크 오류는 다음 실행 때 다시 시도한다.
            }
        }.start()
    }
}

/** firstguest://pair?token=…&server=… 딥링크를 받아 저장하고 바로 닫힌다. */
class FirstGuestPairActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val uri = intent?.data
        val token = uri?.getQueryParameter("token")
        if (token != null && token.length in 16..64) {
            FirstGuest.save(this, token, uri.getQueryParameter("server"))
            FirstGuest.ping(this)
            Toast.makeText(this, "First Guest와 연결했어요", Toast.LENGTH_SHORT).show()
        }
        packageManager.getLaunchIntentForPackage(packageName)?.let { startActivity(it) }
        finish()
    }
}