이 튜토리얼에서는 ConnectivityManager와 NetworkInfo 클래스를 활용하여 안드로이드 앱에서 현재 Wi-Fi 연결 상태를 확인하고 화면에 표시하는 방법을 단계별로 알아봅니다.
1단계: 새 프로젝트 생성
Android Studio를 실행한 뒤, 메뉴에서 File ⇒ New Project를 선택하고 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다.
2단계: 레이아웃 파일 작성
Wi-Fi 연결 상태를 화면에 출력할 TextView를 배치하기 위해 res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.
<?xml version = "1.0" encoding = "utf-8"?>
<LinearLayout xmlns:android = "https://schemas.android.com/apk/res/android"
xmlns:app = "https://schemas.android.com/apk/res-auto"
xmlns:tools = "https://schemas.android.com/tools"
android:layout_width = "match_parent"
android:gravity = "center"
android:layout_height = "match_parent"
tools:context = ".MainActivity">
<TextView
android:id = "@+id/text"
android:textSize = "30sp"
android:layout_width = "match_parent"
android:layout_height = "match_parent" />
</LinearLayout>위 코드에서는 Wi-Fi 연결 상태를 보여주기 위한 TextView 하나를 화면 중앙에 배치했습니다.
3단계: MainActivity 구현
이제 실제로 네트워크 상태를 조회하는 로직을 작성합니다. src/MainActivity.java 파일에 아래 코드를 추가하세요.
package com.example.myapplication;
import android.content.Context;
import android.net.ConnectivityManager;
import android.net.NetworkInfo;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.RequiresApi;
import android.support.v7.app.AppCompatActivity;
import android.widget.TextView;
public class MainActivity extends AppCompatActivity {
TextView textView;
@RequiresApi(api = Build.VERSION_CODES.N)
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
textView = findViewById(R.id.text);
ConnectivityManager connManager = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkInfo networkInfo = connManager.getNetworkInfo(ConnectivityManager.TYPE_WIFI);
textView.setText("" + networkInfo.getDetailedState());
}
@Override
protected void onStop() {
super.onStop();
}
@Override
protected void onResume() {
super.onResume();
}
}위 코드의 핵심 동작은 다음과 같습니다.
- getSystemService(Context.CONNECTIVITY_SERVICE): 시스템의 연결 상태 관리 서비스 인스턴스를 가져옵니다.
- getNetworkInfo(ConnectivityManager.TYPE_WIFI): Wi-Fi 타입 네트워크의 정보 객체를 반환받습니다.
- getDetailedState(): 연결 상태의 세부 정보(예: CONNECTED, CONNECTING, DISCONNECTED 등)를 문자열로 화면에 출력합니다.
4단계: 매니페스트 권한 설정
네트워크 상태에 접근하려면 권한 선언이 필수입니다. AndroidManifest.xml 파일에 아래 코드를 추가합니다.
<?xml version = "1.0" encoding = "utf-8"?>
<manifest xmlns:android = "https://schemas.android.com/apk/res/android"
package = "com.example.myapplication">
<uses-permission android:name = "android.permission.ACCESS_NETWORK_STATE" />
<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" />
<action android:name = "android.net.conn.CONNECTIVITY_CHANGE" />
<category android:name = "android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>여기서 선언된 두 가지 권한의 역할은 다음과 같습니다.
- ACCESS_NETWORK_STATE: 네트워크 연결 상태 정보에 접근할 수 있게 해줍니다.
- ACCESS_WIFI_STATE: Wi-Fi 관련 상태 정보를 조회할 수 있게 해줍니다.
앱 실행 및 결과 확인
이제 애플리케이션을 실행해 결과를 확인해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run(실행) 아이콘을 클릭하세요. 목록에서 본인의 모바일 기기를 선택하면, 기기 화면에 아래와 같이 Wi-Fi 연결 상태가 표시됩니다.
참고 사항
NetworkInfo API는 오래된 방식으로, Android 10(API 29) 이상에서는 공식적으로 지원 중단(deprecated)되었습니다. 최신 버전을 대상으로 개발한다면 NetworkCapabilities와 ConnectivityManager.registerNetworkCallback()을 사용하는 것이 권장됩니다. 다만 학습용 예제나 하위 버전 호환이 필요한 경우에는 위 방법도 여전히 유용하게 활용할 수 있습니다.