개요
이 튜토리얼에서는 Android 앱에서 네트워크 연결 상태(Wi-Fi, 모바일 데이터, 연결 없음)를 확인하고 그 결과를 화면에 표시하는 방법을 단계별로 알아봅니다. ConnectivityManager와 NetworkInfo 클래스를 활용하면 현재 기기가 어떤 네트워크에 연결되어 있는지 손쉽게 판별할 수 있습니다.
1단계: 새 프로젝트 생성
Android Studio를 실행한 뒤 File → New Project 메뉴로 이동하여 새 프로젝트를 생성합니다. 프로젝트 생성에 필요한 모든 세부 정보(프로젝트 이름, 패키지명, 최소 SDK 버전 등)를 입력하고 빈 액티비티(Empty Activity) 템플릿을 선택합니다.
2단계: 레이아웃 파일 작성 (res/layout/activity_main.xml)
연결 상태 아이콘을 보여줄 ImageView, 상태 문구를 표시할 TextView, 그리고 확인 버튼 역할을 할 Button을 배치합니다. 아래 코드를 activity_main.xml에 추가하세요.
<?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android" xmlns:tools="https://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".MainActivity"> <ImageView android:id="@+id/ivConStatus" android:layout_width="150dp" android:layout_height="150dp" android:layout_centerInParent="true" android:layout_marginTop="24sp" android:scaleType="fitCenter" android:contentDescription="@string/todo" /> <TextView android:id="@+id/tvConStatus" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textStyle="bold" android:textSize="24sp" android:layout_centerHorizontal="true" android:padding="4dp" /> <Button android:id="@+id/btnCheckNetwork" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_centerHorizontal="true" android:layout_alignParentBottom="true" android:text="Check Network"/> </RelativeLayout>
레이아웃의 핵심 요소는 다음과 같습니다.
- ivConStatus: Wi-Fi, 모바일 데이터, 연결 없음 상태를 나타내는 아이콘이 표시되는 이미지 뷰
- tvConStatus: 현재 연결 상태를 텍스트로 보여주는 뷰
- btnCheckNetwork: 클릭 시 네트워크 상태를 검사하는 버튼
3단계: 메인 액티비티 코드 작성 (src/MainActivity.java)
버튼 클릭 이벤트가 발생하면 ConnectivityManager를 통해 활성 네트워크 정보를 가져오고, 연결 유형(Wi-Fi 또는 모바일 데이터)에 따라 아이콘과 텍스트를 갱신합니다.
import android.content.Context;
import android.net.ConnectivityManager;
import android.net.NetworkInfo;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
import android.widget.TextView;
public class MainActivity extends AppCompatActivity {
ImageView ivConStatus;
TextView tvconStatus;
Button btnCheckNetwork;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ivConStatus = findViewById(R.id.ivConStatus);
tvconStatus = findViewById(R.id.tvConStatus);
btnCheckNetwork = findViewById(R.id.btnCheckNetwork);
btnCheckNetwork.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
checkNetworkConnectionStatus();
}
});
}
private void checkNetworkConnectionStatus() {
boolean wifiConnected;
boolean mobileDataConnected;
ConnectivityManager cm = (ConnectivityManager)getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkInfo networkInfo = cm.getActiveNetworkInfo();
if (networkInfo!=null && networkInfo.isConnected()){
wifiConnected = networkInfo.getType() == ConnectivityManager.TYPE_WIFI;
mobileDataConnected = networkInfo.getType() == ConnectivityManager.TYPE_MOBILE;
if (wifiConnected){
ivConStatus.setImageResource(R.drawable.ic_wifi);
tvconStatus.setText("WIFI is Connected");
} else if (mobileDataConnected){
ivConStatus.setImageResource(R.drawable.ic_mobiledata);
tvconStatus.setText("Mobile data is Connected");
}
} else {
ivConStatus.setImageResource(R.drawable.ic_dnd);
tvconStatus.setText("No Connections are available");
}
}
}코드 핵심 로직 설명
- getSystemService(Context.CONNECTIVITY_SERVICE): 시스템의 연결 관리 서비스 인스턴스를 가져옵니다.
- getActiveNetworkInfo(): 현재 활성화된 네트워크 정보를 반환하며, 연결이 없으면 null을 리턴합니다.
- getType() 값이 TYPE_WIFI면 Wi-Fi, TYPE_MOBILE이면 모바일 데이터로 판별합니다.
- 연결된 네트워크가 전혀 없는 경우에는 "No Connections are available" 메시지와 함께 오프라인 아이콘을 표시합니다.
유의 사항: 위 예제에서 사용한 ic_wifi, ic_mobiledata, ic_dnd 드로어블 리소스는 res/drawable 폴더에 미리 추가되어 있어야 합니다. 또한 getActiveNetworkInfo()는 API 29(Android 10)부터 지원 중단(deprecated)되었으므로, 최신 환경에서는 NetworkCallback이나 ConnectivityManager.getActiveNetwork() 기반의 구현으로 대체하는 것이 권장됩니다.
4단계: 매니페스트 권한 설정 (androidManifest.xml)
네트워크 상태를 조회하려면 ACCESS_NETWORK_STATE 권한이 반드시 필요합니다. 아래와 같이 AndroidManifest.xml에 권한을 선언합니다.
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample"> <uses-permission android:name="android.permission.ACCESS_NETWORK_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 기기를 컴퓨터에 USB로 연결한 상태라고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭하고, 목록에서 본인의 모바일 기기를 선택하세요. 앱이 실행되면 기기 화면에 아래와 같은 기본 화면이 표시됩니다.
Wi-Fi에 연결된 상태에서 버튼을 누르면 Wi-Fi 아이콘과 함께 "WIFI is Connected" 메시지가, 모바일 데이터 사용 중이라면 해당 아이콘과 메시지가 표시되고, 두 네트워크 모두 꺼져 있으면 오프라인 상태 안내가 출력되는 것을 확인할 수 있습니다.