개요
이 튜토리얼에서는 안드로이드 앱에서 사용 가능한 Wi-Fi 네트워크를 스캔하고, 검색된 네트워크를 ListView에 표시하는 방법을 단계별로 알아봅니다. 스캔 결과 수신에는 BroadcastReceiver를 활용하며, 안드로이드 6.0(마시멜로) 이상에서 필수인 위치 권한 요청 처리 방법도 함께 다룹니다.
1단계: 새 프로젝트 생성
Android Studio에서 File ⇒ New Project로 이동한 후, 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다.
2단계: 레이아웃 파일 작성 (res/layout/activity_main.xml)
다음 코드를 activity_main.xml 파일에 추가합니다. 화면 상단에는 Wi-Fi 목록을 보여줄 ListView가, 하단에는 스캔 버튼이 배치됩니다.
<?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" android:layout_margin = "16dp" android:orientation = "vertical" tools:context = ".MainActivity"> <ListView android:id = "@+id/wifiList" android:layout_width = "match_parent" android:layout_height = "match_parent" android:layout_above = "@+id/scanBtn" /> <Button android:id = "@+id/scanBtn" android:layout_width = "match_parent" android:layout_height = "50dp" android:layout_alignParentBottom = "true" android:layout_gravity = "bottom" android:layout_margin = "15dp" android:text = "Scan WiFi" /> </RelativeLayout>
3단계: 메인 액티비티 구현 (src/MainActivity.java)
다음 코드를 MainActivity.java에 추가합니다. 이 클래스에서는 Wi-Fi 활성화 여부 확인, 스캔 시작, 위치 권한 요청 등 핵심 로직을 처리합니다.
package com.example.myapplication;
import android.Manifest;
import android.content.Context;
import android.content.IntentFilter;
import android.content.pm.PackageManager;
import android.net.wifi.WifiManager;
import android.os.Build;
import android.support.annotation.NonNull;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.ListView;
import android.widget.Toast;
public class MainActivity extends AppCompatActivity {
private ListView wifiList;
private WifiManager wifiManager;
private final int MY_PERMISSIONS_ACCESS_COARSE_LOCATION = 1;
WifiReceiver receiverWifi;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
wifiList = findViewById(R.id.wifiList);
Button buttonScan = findViewById(R.id.scanBtn);
wifiManager = (WifiManager) getApplicationContext().getSystemService(Context.WIFI_SERVICE);
if (!wifiManager.isWifiEnabled()) {
Toast.makeText(getApplicationContext(), "Turning WiFi ON...", Toast.LENGTH_LONG).show();
wifiManager.setWifiEnabled(true);
}
buttonScan.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (ActivityCompat.checkSelfPermission(MainActivity.this, Manifest.permission.ACCESS_COARSE_LOCATION)
!= PackageManager.PERMISSION_GRANTED) {
ActivityCompat.requestPermissions(
MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, MY_PERMISSIONS_ACCESS_COARSE_LOCATION);
} else {
wifiManager.startScan();
}
}
});
}
@Override
protected void onPostResume() {
super.onPostResume();
receiverWifi = new WifiReceiver(wifiManager, wifiList);
IntentFilter intentFilter = new IntentFilter();
intentFilter.addAction(WifiManager.SCAN_RESULTS_AVAILABLE_ACTION);
registerReceiver(receiverWifi, intentFilter);
getWifi();
}
private void getWifi() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
Toast.makeText(MainActivity.this, "version>= marshmallow", Toast.LENGTH_SHORT).show();
if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.ACCESS_COARSE_LOCATION)
!= PackageManager.PERMISSION_GRANTED) {
Toast.makeText(MainActivity.this, "location turned off", Toast.LENGTH_SHORT).show();
ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION},
MY_PERMISSIONS_ACCESS_COARSE_LOCATION);
} else {
Toast.makeText(MainActivity.this, "location turned on", Toast.LENGTH_SHORT).show();
wifiManager.startScan();
}
} else {
Toast.makeText(MainActivity.this, "scanning", Toast.LENGTH_SHORT).show();
wifiManager.startScan();
}
}
@Override
protected void onPause() {
super.onPause();
unregisterReceiver(receiverWifi);
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
switch (requestCode) {
case MY_PERMISSIONS_ACCESS_COARSE_LOCATION:
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
Toast.makeText(MainActivity.this, "permission granted", Toast.LENGTH_SHORT).show();
wifiManager.startScan();
} else {
Toast.makeText(MainActivity.this, "permission not granted", Toast.LENGTH_SHORT).show();
return;
}
break;
}
}
}4단계: 브로드캐스트 리시버 구현 (src/WifiReceiver.java)
다음 코드를 WifiReceiver.java에 추가합니다. 이 리시버는 Wi-Fi 스캔 완료 시스템 브로드캐스트(SCAN_RESULTS_AVAILABLE_ACTION)를 수신하면 스캔 결과를 읽어 ListView에 갱신합니다.
package com.example.myapplication;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.net.wifi.ScanResult;
import android.net.wifi.WifiManager;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.Toast;
import java.util.ArrayList;
import java.util.List;
class WifiReceiver extends BroadcastReceiver {
WifiManager wifiManager;
StringBuilder sb;
ListView wifiDeviceList;
public WifiReceiver(WifiManager wifiManager, ListView wifiDeviceList) {
this.wifiManager = wifiManager;
this.wifiDeviceList = wifiDeviceList;
}
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
if (WifiManager.SCAN_RESULTS_AVAILABLE_ACTION.equals(action)) {
sb = new StringBuilder();
List<ScanResult> wifiList = wifiManager.getScanResults();
ArrayList<String> deviceList = new ArrayList<>();
for (ScanResult scanResult : wifiList) {
sb.append("\n").append(scanResult.SSID).append(" - ").append(scanResult.capabilities);
deviceList.add(scanResult.SSID + " - " + scanResult.capabilities);
}
Toast.makeText(context, sb, Toast.LENGTH_SHORT).show();
ArrayAdapter arrayAdapter = new ArrayAdapter(context, android.R.layout.simple_list_item_1, deviceList.toArray());
wifiDeviceList.setAdapter(arrayAdapter);
}
}
}5단계: 매니페스트 설정 (androidManifest.xml)
마지막으로 다음 코드를 AndroidManifest.xml에 추가하여 필요한 권한들을 선언합니다. Wi-Fi 스캔에는 위치 권한(ACCESS_COARSE_LOCATION), Wi-Fi 상태 조회 권한(ACCESS_WIFI_STATE), Wi-Fi 상태 변경 권한(CHANGE_WIFI_STATE)이 필요합니다.
<?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_COARSE_LOCATION" /> <uses-permission android:name = "android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name = "android.permission.CHANGE_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 = "com.example.myapplication.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 아이콘을 클릭하세요. 기기 목록에서 자신의 모바일 기기를 선택하면, 해당 기기에 앱의 기본 화면이 표시됩니다.

참고: 안드로이드 6.0(API 23) 이상에서는 Wi-Fi 스캔 결과를 얻기 위해 위치 권한뿐만 아니라 기기의 위치 서비스도 켜져 있어야 합니다. 따라서 테스트 전에 설정에서 위치 서비스를 활성화해 두는 것이 좋습니다.