Wifi

Mô-đun Wi-Fi có thể cập nhật, nghĩa là nó có thể nhận các bản cập nhật cho chức năng bên ngoài chu kỳ phát hành Android thông thường. Mô-đun này chứa các thành phần sau.

Các thành phần mô-đun Wi-Fi

Hình 1. Kiến trúc và các thành phần của mô-đun Wi-Fi

Mô-đun Wi-Fi cung cấp các lợi ích sau.

  • Người dùng cuối nhận được trải nghiệm Wi-Fi nhất quán trên các thiết bị Android và khắc phục các sự cố về khả năng tương tác thông qua các bản cập nhật mô-đun.

  • Các nhà phát triển ứng dụng giảm được tình trạng phân mảnh nền tảng.

  • OEM có thể đáp ứng các yêu cầu của nhà cung cấp dịch vụ đồng thời giảm chi phí cho các tùy chỉnh riêng lẻ (vì họ không cần triển khai khác nhau cho cùng một yêu cầu theo những cách khác nhau).

Ranh giới mô-đun cho Android 12 và Android 13

  • packages/modules/Wifi
    • framework
      • java/
        • android/net/wifi (tệp từ frameworks/base/wifi/java )
      • tests/
        • android/net/wifi (tệp từ frameworks/base/wifi/tests )
      • aidl-export/
      • api/
      • Android.bp
    • service/
      • java/
        • com/android/server/wifi (tệp từ frameworks/opt/net/wifi/service/java )
      • tests/
        • com/android/server/wifi (tệp từ frameworks/opt/net/wifi/tests )
      • proto/
      • Android.bp
      • proguard.flags
      • wifi.rc
    • OsuLogin/ (tệp từ frameworks/base/packages/OsuLogin )
    • ServiceResources/ (mới trong Android 12, tệp kê khai APK lớp phủ được lưu trữ tại đây)
      • res/ (mới trong Android 11, cấu hình Wi-Fi được trích xuất từ frameworks/base/core/res/res )
      • AndroidManifest.xml
      • Android.bp
    • WifiDialog/ (tính năng mới trong Ứng dụng Android 13 để khởi chạy hộp thoại người dùng theo yêu cầu của dịch vụ được lưu trữ tại đây.)
      • src/
        • com/android/wifi/dialog (Chứa Hoạt động mà các hộp thoại được khởi chạy từ đó)
      • AndroidManifest.xml
      • Android.bp

Các thư mục trên cũng chứa mã nằm ngoài thành phần hệ thống mô-đun và ở vị trí hiện tại của nó, ví dụ:

  • wificond interface (các lớp trong gói android.net.wifi.nl80211 , ví dụ: WifiNl80211Manager )
  • Ứng dụng lớp phủ tài nguyên mẫu
  • WifiTrackerLib
  • libwifi_hal
  • libwifi_system
  • libwifi_system_iface

Các OEM có thể sử dụng các lệnh mẫu để giúp di chuyển các bản vá của họ từ thư mục dự án ban đầu sang thư mục dự án mới.

Di chuyển một bản vá từ khung/cơ sở/wifi

Tạo tệp vá trong root/frameworks/base/wifi

git format-patch -1 commit --stdout > patch-file.txt

Áp dụng tệp vá cho root/gói/mô-đun/Wifi

git am -p2 --directory=framework/ patch-file.txt

Di chuyển một bản vá từ frameworks/opt/net/wifi

Để di chuyển bản vá từ frameworks/opt/net/wifi , cần thực hiện các bước phức tạp vì hệ thống phân cấp thư mục đã thay đổi trong quá trình di chuyển.

Trong frameworks/opt/net/wifi , hãy chia cam kết thành hai lần xác nhận, một cho service/ và một cho tests/ .

Di chuyển cam kết HEAD

git reset HEAD^
git add service/
git commit # Enter your commit message. Call this commit service-commit
git add tests/
git commit # Enter your commit message. Call this commit test-commit

Tạo hai tệp vá cam kết

git format-patch -1 service-commit --stdout > service-patch.txt
git format-patch -1 test-commit --stdout > test-patch.txt

Áp dụng hai bản vá cho các gói/mô-đun/Wifi

git am service-patch.txt
git am -p1 --directory=service/ test-patch.txt

Ném hai cam kết trở lại thành một cam kết

git rebase -i

Thay đổi hoạt động của lần xác nhận thứ hai thành squash .

Chỉnh sửa thông báo cam kết cho phù hợp.

Ranh giới mô-đun cho Android 11

Dịch vụ Wi-Fi tiếp tục chạy bên trong quy trình Dịch vụ Hệ thống. Mô-đun Wi-Fi bao gồm tất cả mã trong packages/modules/Wifi bao gồm mã sau.

  • SDK và các lớp dịch vụ cho WifiService , WifiP2pService , WifiAwareService , WifiScannerServiceWifiRttService
  • OsuLogin
  • ServiceWifiResources

Mô-đun này không bao gồm các thành phần sau, vẫn là một phần của bản dựng AOSP của OEM.

  • thành phần gốc wificond trong system/connectivity/wificond
  • giao diện wificond (các lớp trong gói android.net.wifi.nl80211 , ví dụ: WifiNl80211Manager )
  • android.net.wifi.SoftApConfToXmlMigrationUtil
  • android.net.wifi.WifiNetworkScoreCache
  • android.net.wifi.WifiMigration
  • WifiTrackerLib
  • libwifi_hal
  • libwifi_system
  • libwifi_system_iface

Android 11 không di chuyển tệp, nhưng các bản phát hành trong tương lai thì có thể. Để giảm bớt nỗ lực liên quan đến việc chuyển các thay đổi vị trí tệp, chúng tôi khuyên bạn nên ngược dòng nhiều thay đổi nhất có thể đối với AOSP (sau khi chuyển chúng sang Android 11 hoặc tái cấu trúc các tiện ích mở rộng độc quyền để sử dụng API Android chính thức hoặc tiện ích mở rộng HAL của nhà cung cấp để gỡ rối chúng khỏi mã AOSP.

định dạng mô-đun

Mô-đun Wi-Fi ( com.android.wifi ) ở định dạng APEX và khả dụng cho các thiết bị chạy Android 11 trở lên. Tệp APEX bao gồm các thành phần sau.

  • Thư viện SDK ( framework-wifi.jar )
  • Thư viện dịch vụ ( service-wifi.jar )
  • APK OsuLogin ( OsuLoginGoogle.apk )
  • APK tài nguyên ( ServiceWifiResourcesGoogle.apk )
  • chứng chỉ WFA

phụ thuộc mô-đun

Mô-đun Wi-Fi phụ thuộc vào các thành phần sau.

  • kết nối
  • điện thoại
  • thư viện nguyên mẫu
  • Các thành phần hệ thống linh tinh
  • WiFi HAL
  • wificond
  • bouncycastle
  • ksoap2
  • libnanohttpd

Mô-đun này tương tác với khung chỉ sử dụng @SystemApi ổn định (không sử dụng @hide API) và được ký bằng chữ ký Google thay vì chữ ký nền tảng.

tùy chỉnh

Mô-đun Wi-Fi không hỗ trợ tùy chỉnh trực tiếp nhưng bạn có thể tùy chỉnh cấu hình bằng cách sử dụng lớp phủ tài nguyên thời gian chạy (RRO) hoặc cấu hình mạng di động.

tùy chỉnh wifi

Hình 2. Tùy chỉnh mô-đun Wi-Fi

  • Đối với các tùy chỉnh nhỏ, hãy bật hoặc tắt cài đặt trong config RRO.
  • Để kiểm soát nhiều hơn, hãy tùy chỉnh các giá trị cấu hình cho bất kỳ khóa cấu hình mạng di động nào được hiển thị dưới dạng @SystemAPI .

Sử dụng lớp phủ tài nguyên thời gian chạy

Bạn có thể tùy chỉnh mô-đun Wi-Fi bằng cách ghi đè các cấu hình mặc định bằng RRO. Để biết danh sách các cấu hình có thể xếp chồng lên nhau, hãy tham khảo packages/modules/Wifi/service/ServiceWifiResources/res/values/overlayable.xml . Để biết chi tiết về hành vi cấu hình, hãy tham khảo packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml . Để biết ứng dụng lớp phủ mẫu, hãy tham khảo device/google/coral/rro_overlays/WifiOverlay/ .

Vì tệp device/google/coral/rro_overlays/WifiOverlay/AndroidManifest.xml đặt thuộc tính targetPackage thành com.android.wifi.resources và APK tài nguyên do mô-đun Wi-Fi phân phối có tên gói là com.google.android.wifi.resources , bạn phải đặt Gói mục tiêu targetPackage lớp phủ thành com.google.android.wifi.resources để cấu hình Wi-Fi lớp phủ thành công.

Di chuyển định dạng lưu trữ cấu hình

Mô-đun Wi-Fi chỉ có thể phân tích cú pháp định dạng lưu trữ cấu hình AOSP Wi-Fi. Nếu trước đây bạn đã sửa đổi định dạng lưu trữ cấu hình Wi-Fi (bao gồm danh sách mạng đã lưu của người dùng), thì bạn phải chuyển đổi dữ liệu đó sang định dạng AOSP khi nâng cấp thiết bị lên bất kỳ bản phát hành Android nào có mô-đun Wi-Fi. Các hook cần thiết cho quá trình chuyển đổi này nằm trong lớp android.net.wifi.WifiMigration .

Thực hiện chuyển đổi định dạng theo các phương pháp sau.

  • WifiMigration.convertAndRetrieveSharedConfigStoreFile(<storeFileId>)

    • Được gọi bởi mô-đun Wi-Fi để truy xuất nội dung tệp cửa hàng chia sẻ Wi-Fi đã được chuyển đổi sang định dạng AOSP.

    • Các tệp này trước đây (trong Android 10) được lưu trữ trong thư mục /data/misc/wifi trên thiết bị.

  • WifiMigration.convertAndRetrieveUserConfigStoreFile(<storeFileId>)

    • Được gọi bởi mô-đun Wi-Fi để truy xuất nội dung tệp lưu trữ dành riêng cho người dùng Wi-Fi đã được chuyển đổi sang định dạng AOSP.

    • Các tệp này trước đây (trong Android 10) được lưu trữ trong thư mục /data/misc_ce/<userId>/wifi trên thiết bị.

Truy cập các API Wi-Fi ẩn

Các ký hiệu (lớp, phương thức, trường, v.v.) được chú thích bằng @hide trong mô-đun Wi-Fi không phải là một phần của bề mặt API công khai và không thể truy cập được trên các thiết bị đã cài đặt mô-đun. Các thiết bị không bao gồm mô-đun Wi-Fi có thể tiếp tục sử dụng @hide Wi-Fi bằng các bước sau.

  1. Xóa các hạn chế về khả năng hiển thị được đặt trên framework-wifi tại packages/modules/Wifi/framework/Android.bp bằng cách thay đổi thuộc tính impl_library_visibility thành công khai.

    java_sdk_library {
        name: "framework-wifi",
        ...
        impl_library_visibility: [
           "//visibility:public", // Add this rule and remove others.
        ],
        ...
    }
    
  2. Thay đổi quy tắc xây dựng để cho phép truy cập thư viện @hide Wi-Fi API. Ví dụ: sau đây là quy tắc xây dựng cho java_library .

    java_library {
        name: "foo-lib",
    
        // no sdk_version attribute defined
    
        libs: [
            "dependency1",
            "dependency2",
        ],
    }
    

    Để cho phép truy cập thư viện cho foo-lib , hãy thay đổi quy tắc xây dựng như bên dưới.

    java_library {
        name: "foo-lib",
    
        sdk_version: "core_platform",
    
        libs: [
            "framework-wifi.impl",
            "framework",
            "dependency1",
            "dependency2",
        ],
    }
    
  3. Đảm bảo rằng framework-wifi.impl xuất hiện trước framework trong danh sách libs . Thứ tự của các thành phần phụ thuộc trong thuộc tính libs là rất quan trọng.

Truy cập API khung ẩn

Không thể truy cập các biểu tượng được chú thích bằng @hide bên ngoài mô-đun Wi-Fi bằng mã bên trong mô-đun Wi-Fi. Các thiết bị không bao gồm mô-đun Wi-Fi có thể tiếp tục sử dụng @hide API bên ngoài (ví dụ: từ framework.jar ) trong service-wifi bằng cách thực hiện các sửa đổi sau đối với frameworks/opt/net/wifi/service/Android.bp .

  1. Trong cả wifi-service-pre-jarjarservice-wifi , hãy thay đổi thuộc tính sdk_version thành core_platform .

  2. Trong cả wifi-service-pre-jarjarservice-wifi , hãy thêm frameworkandroid_system_server_stubs_current vào thuộc tính libs .

  3. Xác minh kết quả tương tự như mẫu mã sau đây.

    java_library {
        name: "wifi-service-pre-jarjar",
        ...
        sdk_version: "core_platform",
        ...
        libs: [
            ...
            "framework",
            "android_system_server_stubs_current",
        ],
    }
    ...
    java_library {
        name: "service-wifi",
        ...
        sdk_version: "core_platform",
        ...
        libs: [
            ...
            "framework",
            "android_system_server_stubs_current",
        ],
    }
    

thử nghiệm

Bộ kiểm tra khả năng tương thích Android (CTS) xác minh chức năng của mô-đun Wi-Fi bằng cách chạy một bộ kiểm tra CTS toàn diện trên mọi bản phát hành mô-đun. Bạn cũng có thể chạy các kiểm tra được mô tả trong Kiểm tra, Gỡ lỗi và Điều chỉnh Wi-Fi .