안드로이드 Wi-Fi 온/오프 기반 네트워크 리스너 만드는 방법 (단계별 코드 예제)

개요

이 튜토리얼에서는 네트워크의 온/오프 상태를 기준으로 안드로이드 기기의 네트워크 리스너를 구현하는 방법을 알아봅니다. 화면에는 현재 활성화된 네트워크 유형을 표시하는 토스트 메시지와 함께, Wi-Fi를 켜고 끌 수 있는 두 개의 버튼을 배치합니다.

1단계: 새 프로젝트 생성

Android Studio에서 File ⇒ New Project를 선택하여 새 프로젝트를 생성하고, 필요한 모든 세부 정보를 입력해 프로젝트 설정을 완료합니다.

2단계: 레이아웃 작성 (res/layout/activity_main.xml)

아래 코드를 res/layout/activity_main.xml 파일에 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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"
    android:orientation="vertical"
    android:padding="16dp"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="30dp"
        android:text="네트워크 온/오프 기반 안드로이드 기기 네트워크 리스너"
        android:textSize="24sp"
        android:textStyle="bold" />

    <Button
        android:layout_marginTop="30dp"
        android:onClick="SwitchWIFION"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Wi-Fi 켜기" />

    <Button
        android:layout_marginTop="10dp"
        android:onClick="SwitchWIFIOFF"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Wi-Fi 끄기" />

</LinearLayout>

3단계: 메인 액티비티 작성 (src/MainActivity.java)

다음 코드를 src/MainActivity.java 파일에 추가합니다. 이 클래스에서는 ConnectivityManager를 통해 현재 활성화된 네트워크와 모바일 네트워크 정보를 가져오고, WifiManager로 Wi-Fi 상태를 전환합니다.

import androidx.appcompat.app.AppCompatActivity;
import android.content.Context;
import android.net.ConnectivityManager;
import android.net.NetworkInfo;
import android.net.wifi.WifiManager;
import android.os.Bundle;
import android.view.View;
import android.widget.Toast;
import java.util.Objects;

public class MainActivity extends AppCompatActivity {

    WifiManager wifiManager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        wifiManager = (WifiManager) getApplicationContext().getSystemService(WIFI_SERVICE);

        ConnectivityManager connectivityManager = (ConnectivityManager)
                getApplicationContext().getSystemService(Context.CONNECTIVITY_SERVICE);

        NetworkInfo activeNetInfo =
                Objects.requireNonNull(connectivityManager).getActiveNetworkInfo();

        NetworkInfo mobNetInfo =
                connectivityManager.getNetworkInfo(ConnectivityManager.TYPE_MOBILE);

        if (activeNetInfo != null) {
            Toast.makeText(getApplicationContext(), "활성 네트워크 유형 : " +
                    activeNetInfo.getTypeName(), Toast.LENGTH_SHORT).show();
        }

        if (mobNetInfo != null) {
            Toast.makeText(getApplicationContext(), "모바일 네트워크 유형 : " +
                    mobNetInfo.getTypeName(), Toast.LENGTH_SHORT).show();
        }
    }

    public void SwitchWIFION(View view) {
        Objects.requireNonNull(wifiManager).setWifiEnabled(true);
        Toast.makeText(getApplicationContext(), "WI-FI가 켜졌습니다",
                Toast.LENGTH_SHORT).show();
    }

    public void SwitchWIFIOFF(View view) {
        Objects.requireNonNull(wifiManager).setWifiEnabled(false);
        Toast.makeText(getApplicationContext(), "WI-FI가 꺼졌습니다",
                Toast.LENGTH_SHORT).show();
    }
}

4단계: 권한 설정 (androidManifest.xml)

네트워크 상태 확인과 Wi-Fi 제어를 위해 매니페스트 파일에 아래와 같이 권한을 선언합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.sample">

    <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>

    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

</manifest>

앱 실행하기

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 열고, 툴바의 Run 아이콘을 클릭합니다. 실행 대상으로 실제 모바일 기기를 선택하면, 기기 화면에 앱의 기본 화면이 나타납니다.

참고 사항

위 예제에서 사용된 NetworkInfo와 WifiManager.setWifiEnabled()는 최신 안드로이드 API(API 29 이상)에서 공식적으로 지원 중단(deprecated)되었습니다. 최신 버전을 대상으로 개발하는 경우에는 ConnectivityManager.NetworkCallback을 사용해 네트워크 변화를 실시간으로 감지하고, Wi-Fi 제어는 Settings.Panel.ACTION_WIFI 인텐트를 통해 사용자를 설정 패널로 안내하는 방식을 권장합니다. 다만 학습 목적의 기본 개념 이해에는 위 코드가 여전히 유용한 참고 자료가 됩니다.