android-17-ble-migration

Audit Android 17 BLE apps for silent behavioral regressions.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/trancee/MeshLink-template --skill android-17-ble-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: android-17-ble-migration
Source: https://github.com/trancee/MeshLink-template/tree/main/.agents/skills/android-17-ble-migration
Command: npx skills add https://github.com/trancee/MeshLink-template --skill android-17-ble-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the silent, non-crashing behavioral changes in Android 17 that cause BLE apps to fail, such as hung sockets, muted background alerts, and blocked scan operations.

Core Features & Use Cases

  • Lifecycle Auditing: Identifies critical issues like BluetoothSocket read loops, scan rate throttling, and background activity launch restrictions.
  • Migration Guidance: Provides actionable patterns for implementing PendingIntent-based scanning, proper foreground service types, and stable device identification.
  • Use Case: Use this Skill when your BLE application experiences silent scan failures, background connection drops, or unexpected security exceptions after targeting Android 17.

Quick Start

Use the android-17-ble-migration skill to audit my current BluetoothSocket implementation and suggest fixes for Android 17 compatibility.

Frequently Asked Questions about android-17-ble-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my Android 17 BLE app experience silent scan failures and background connection drops?

Android 17 BLE background execution compliance requires declaring proper foreground service types and migrating to PendingIntent-based scanning to prevent muted background alerts and blocked operations.

What is the best way to fix BluetoothSocket hung connections on Android 17?

Fixing BluetoothSocket hung connections on Android 17 requires auditing read loops for silent disconnection detection failures. You must implement targeted remediation strategies for socket lifecycle management to ensure stable BLE connectivity.

How do I implement PendingIntent-based scanning for Android 17 Bluetooth Low Energy?

Implement PendingIntent-based scanning for Android 17 Bluetooth Low Energy by migrating active scan callbacks to background-compatible patterns. This resolves blocked scan operations and ensures stable BLE connectivity under modern Android constraints.

Do I need to update foreground service types for BLE apps targeting Android 17?

You need to update foreground service types for BLE apps targeting Android 17 to maintain background execution compliance. Proper foreground service declarations prevent silent background execution failures and ensure stable device connectivity.

How does Android 17 handle device identity management for Bluetooth Low Energy connections?

Android 17 device identity management for Bluetooth Low Energy involves resolving stable identification issues causing silent behavioral regressions. Proper identity management patterns ensure your BLE application maintains reliable connections across modern Android versions.