Kotlin으로 안드로이드 기기의 IP 주소를 프로그래밍 방식으로 가져오는 방법

이 튜토리얼에서는 Kotlin을 사용하여 안드로이드 기기의 IP 주소를 프로그래밍 방식으로 가져오는 방법을 단계별로 알아봅니다. Wi-Fi 연결 상태에서 기기가 할당받은 IP 주소를 화면에 표시하는 간단한 예제 앱을 만들어 보겠습니다.

1단계: 새 프로젝트 생성

Android Studio를 실행하고 File → New Project 메뉴로 이동한 뒤, 필요한 모든 세부 정보를 입력하여 새 프로젝트를 생성합니다.

2단계: 레이아웃 파일 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 이 레이아웃에는 앱 제목과 기기의 IP 주소를 표시할 TextView가 포함되어 있습니다.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_margin="16dp"
    android:orientation="vertical">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="50dp"
        android:text="Tutorials Point"
        android:textAlignment="center"
        android:textColor="@android:color/holo_green_dark"
        android:textSize="32sp"
        android:textStyle="bold" />
    <TextView
        android:id="@+id/getIPAddress"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:textAlignment="center"
        android:textColor="@android:color/background_dark"
        android:text="IP address of your Device"
        android:textSize="24sp"
        android:textStyle="bold" />
</RelativeLayout>

3단계: MainActivity.kt 작성

src/MainActivity.kt 파일에 아래 코드를 추가합니다. 여기서는 WifiManager를 통해 Wi-Fi 연결 정보를 가져오고, Formatter.formatIpAddress() 메서드를 사용해 정수형 IP 값을 사람이 읽을 수 있는 문자열 형태로 변환합니다.

import android.content.Context
import android.net.wifi.WifiManager
import android.os.Bundle
import android.text.format.Formatter
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        val textView: TextView = findViewById(R.id.getIPAddress)
        val wifiManager = applicationContext.getSystemService(Context.WIFI_SERVICE) as WifiManager
        val ipAddress: String = Formatter.formatIpAddress(wifiManager.connectionInfo.ipAddress)
        textView.text = "Your Device IP Address: $ipAddress"
    }
}

4단계: 매니페스트에 권한 추가

AndroidManifest.xml 파일에 아래 코드를 추가합니다. Wi-Fi 상태 정보에 접근하려면 ACCESS_WIFI_STATE 권한이 반드시 필요합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.q11">
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    <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/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 스마트폰이 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 실행(Run) 아이콘을 클릭하세요. 실행 옵션 목록에서 본인의 모바일 기기를 선택하면, 앱이 기기에 설치되고 기본 화면이 표시됩니다.

앱이 정상적으로 실행되면 화면 중앙에 현재 Wi-Fi 네트워크에서 할당받은 기기의 IP 주소가 나타납니다.

Kotlin으로 안드로이드 기기의 IP 주소를 프로그래밍 방식으로 가져오는 방법

참고 사항

위 예제는 Wi-Fi에 연결된 환경에서 동작합니다. 모바일 데이터(셀룰러) 네트워크나 VPN 사용 시에는 값이 다르게 표시될 수 있으며, Wi-Fi가 꺼져 있으면 0.0.0.0이 반환됩니다. 또한 최신 API 레벨에서는 Formatter.formatIpAddress()가 deprecated 상태이므로, NetworkInterface를 활용한 방식이나 ConnectivityManager 기반 접근을 함께 고려해 보는 것이 좋습니다.