Android应用首次安装时getDeviceLocation未执行，无法显示用户位置的解决咨询

Hey there! Let's dig into why your Android app isn't fetching the user's location on first launch—this is a super common issue tied to permission timing and location service readiness, so let's break down the fixes step by step.

Core Root Cause #

On first install, your app doesn't have location permissions yet, and if your code doesn't handle the permission grant callback properly, the getDeviceLocation() method never gets triggered. On subsequent launches, the permissions are already granted, so the method runs as expected. We need to tie permission approval directly to triggering location retrieval, plus handle edge cases like disabled location services or empty cached locations.

Step-by-Step Fixes #

1. Tie Permission Requests to Location Retrieval #

First, ensure you're checking for location permissions upfront, and triggering getDeviceLocation() the moment the user grants access. Use the modern ActivityResultContracts API (instead of the old onRequestPermissionsResult) for cleaner, more maintainable code:

// Initialize permission launcher in your Activity/Fragment
private val requestLocationPermissionLauncher = registerForActivityResult(
    ActivityResultContracts.RequestPermission()
) { isGranted: Boolean ->
    if (isGranted) {
        // Permission approved—immediately fetch location
        getDeviceLocation()
    } else {
        // Handle denial: Show a toast or dialog guiding users to enable permissions in settings
        Toast.makeText(this, "Location permission is required to show your address", Toast.LENGTH_SHORT).show()
    }
}

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    // Check permissions on first launch
    when {
        ContextCompat.checkSelfPermission(
            this,
            Manifest.permission.ACCESS_FINE_LOCATION
        ) == PackageManager.PERMISSION_GRANTED -> {
            // Permissions already exist—fetch location right away
            getDeviceLocation()
        }
        shouldShowRequestPermissionRationale(Manifest.permission.ACCESS_FINE_LOCATION) -> {
            // Show a rationale dialog before requesting permission
            AlertDialog.Builder(this)
                .setMessage("We need your location to display your current address and save it to our database")
                .setPositiveButton("Allow") { _, _ ->
                    requestLocationPermissionLauncher.launch(Manifest.permission.ACCESS_FINE_LOCATION)
                }
                .setNegativeButton("Cancel", null)
                .show()
        }
        else -> {
            // Directly request permission if no rationale is needed
            requestLocationPermissionLauncher.launch(Manifest.permission.ACCESS_FINE_LOCATION)
        }
    }
}

2. Check for Enabled Location Services #

Even with permissions, location services might be disabled on the user's device. Add a check in getDeviceLocation() and guide users to enable them if needed:

private fun getDeviceLocation() {
    val locationManager = getSystemService(Context.LOCATION_SERVICE) as LocationManager
    val isGpsEnabled = locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)
    val isNetworkEnabled = locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER)

    if (!isGpsEnabled && !isNetworkEnabled) {
        // Location services are off—prompt user to enable them
        AlertDialog.Builder(this)
            .setMessage("Please enable location services to fetch your address")
            .setPositiveButton("Go to Settings") { _, _ ->
                startActivity(Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS))
            }
            .setNegativeButton("Cancel", null)
            .show()
        return
    }

    // Proceed with your existing location fetch logic (using FusedLocationProviderClient is recommended)
    val fusedLocationClient = LocationServices.getFusedLocationProviderClient(this)
    if (ActivityCompat.checkSelfPermission(
            this,
            Manifest.permission.ACCESS_FINE_LOCATION
        ) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(
            this,
            Manifest.permission.ACCESS_COARSE_LOCATION
        ) != PackageManager.PERMISSION_GRANTED
    ) {
        return
    }
    fusedLocationClient.lastLocation.addOnSuccessListener { location ->
        location?.let {
            // Convert location to address and save to database
            resolveAddressAndSave(it)
        } ?: run {
            // No cached location—request real-time updates
            requestRealTimeLocationUpdates()
        }
    }
}

3. Handle Empty Cached Location #

On first launch, lastLocation might return null because the system hasn't cached a location yet. Request real-time location updates to get a fresh fix:

private fun requestRealTimeLocationUpdates() {
    val locationRequest = LocationRequest.create().apply {
        priority = LocationRequest.PRIORITY_HIGH_ACCURACY
        interval = 10000 // 10 seconds
        fastestInterval = 5000 // 5 seconds
    }

    val fusedLocationClient = LocationServices.getFusedLocationProviderClient(this)
    if (ActivityCompat.checkSelfPermission(
            this,
            Manifest.permission.ACCESS_FINE_LOCATION
        ) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(
            this,
            Manifest.permission.ACCESS_COARSE_LOCATION
        ) != PackageManager.PERMISSION_GRANTED
    ) {
        return
    }
    fusedLocationClient.requestLocationUpdates(
        locationRequest,
        object : LocationCallback() {
            override fun onLocationResult(locationResult: LocationResult) {
                super.onLocationResult(locationResult)
                locationResult.lastLocation?.let {
                    resolveAddressAndSave(it)
                    // Stop updates once we have a valid location
                    fusedLocationClient.removeLocationUpdates(this)
                }
            }
        },
        Looper.getMainLooper()
    )
}

4. Safely Resolve Addresses and Save to Database #

Address resolution (via Geocoder) is a blocking operation, so run it on a background thread. Then save the address to your database (also on a background thread) before updating the UI:

private fun resolveAddressAndSave(location: Location) {
    CoroutineScope(Dispatchers.IO).launch {
        val geocoder = Geocoder(this@MainActivity, Locale.getDefault())
        try {
            val addresses = geocoder.getFromLocation(location.latitude, location.longitude, 1)
            addresses?.firstOrNull()?.let { address ->
                val fullAddress = address.getAddressLine(0) ?: "Unknown location"
                // Save to database (replace with your DAO call)
                yourAppDatabase.addressDao().insertAddress(fullAddress)
                
                // Update UI on main thread
                withContext(Dispatchers.Main) {
                    addressDisplayTextView.text = fullAddress
                }
            }
        } catch (e: IOException) {
            e.printStackTrace()
            withContext(Dispatchers.Main) {
                Toast.makeText(this@MainActivity, "Failed to resolve address", Toast.LENGTH_SHORT).show()
            }
        }
    }
}

Final Notes #

By tying permission grants directly to location retrieval, handling disabled location services, and accounting for empty cached locations, your app will reliably fetch and save the user's address on first launch.

内容的提问来源于stack exchange，提问作者rnarware