개요
이 튜토리얼에서는 Android 앱에서 현재 인터넷 연결 유형(Wi-Fi, 모바일 데이터 등)을 확인하는 방법을 단계별로 알아봅니다. ConnectivityManager를 활용하면 기기의 네트워크 상태를 간단하게 조회할 수 있습니다.
1단계: 새 프로젝트 생성
Android Studio를 실행한 후 File → New Project를 선택하고, 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다.
2단계: 레이아웃 파일 작성
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>위 코드에서는 네트워크 연결 유형을 화면에 표시하기 위해 TextView 하나를 배치했습니다.
3단계: MainActivity.java 작성
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.getTypeName());
}
@Override
protected void onStop() {
super.onStop();
}
@Override
protected void onResume() {
super.onResume();
}
}위 코드의 핵심 동작은 다음과 같습니다. 먼저 시스템 서비스에서 ConnectivityManager 인스턴스를 가져온 뒤, getNetworkInfo(ConnectivityManager.TYPE_WIFI)로 Wi-Fi 네트워크 정보를 조회합니다. 이후 getTypeName() 메서드를 호출하면 연결 유형의 이름(예: "WIFI")이 반환되며, 이 값을 TextView에 출력합니다.
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 권한이 반드시 선언되어 있어야 합니다. 이 권한들은 일반 권한(normal permission)이므로 런타임 요청 없이 매니페스트에만 선언하면 됩니다.
앱 실행 및 결과 확인
실제 Android 기기를 컴퓨터에 연결한 상태라고 가정하고 앱을 실행해 보겠습니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 버튼을 클릭합니다. 실행 대상 목록에서 본인의 모바일 기기를 선택하면, 기기 화면에 현재 연결 유형이 표시됩니다.
참고: 최신 API에서의 변경 사항
NetworkInfo와 getNetworkInfo() 메서드는 API 29(Android 10, Q)부터 공식적으로 deprecated되었습니다. 최신 Android 버전까지 안정적으로 지원하려면 ConnectivityManager.getActiveNetwork()로 Network 객체를 얻은 후, getNetworkCapabilities(network)를 통해 NetworkCapabilities를 확인하는 방식을 사용하는 것이 좋습니다. 예를 들어 hasTransport(NetworkCapabilities.TRANSPORT_WIFI)가 true이면 Wi-Fi에 연결된 것으로 판단할 수 있습니다.