Skip to content

Commit 4e10240

Browse files
natiginfogithub-actions[bot]
authored andcommitted
Update symbolication guide as NDK 27 symbols are not published (#14933)
GitOrigin-RevId: 597e418d2c3fb4691e3cf7af7f93045b3855a77c
1 parent 45c3440 commit 4e10240

1 file changed

Lines changed: 1 addition & 36 deletions

File tree

DEVELOPING.md

Lines changed: 1 addition & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -395,42 +395,7 @@ A great bug report will have many of the following:
395395
## Symbolicating native crashes
396396

397397
The Mapbox Maps SDK for Android uses C++ code under the hood. By default, the used C++ binary
398-
will be stripped from symbols which means that stacktraces produced are not readable. To symbolicate
399-
C++ traces you can use [ndk-stack](https://developer.android.com/ndk/guides/ndk-stack) and a binary that has the symbols attached.
400-
401-
### Download the unstripped binary
402-
403-
Next to Mapbox Maven distribution mechanism, Mapbox Android binaries can be downloaded as a zipped
404-
archive. This zipped version contains the additional shared objects with debug symbols.
405-
Replace in following command the SDK_REGISTRY_TOKEN and VERSION with the appropriate values:
406-
407-
```
408-
$ curl --user mapbox:{SDK_REGISTRY_TOKEN} https://api.mapbox.com/downloads/v2/mobile-maps-android-core/releases/android/{VERSION}/android-core-all.zip --output android-core-all.zip
409-
```
410-
411-
### Running NDK stack
412-
413-
After unzipping the archive you can run ndk-stack on the unstripped native binary and your
414-
stacktrace that was saved as a txt file.
415-
416-
```
417-
$ ndk-stack -sym obj/arm64-v8a -dump trace.txt
418-
```
419-
420-
Note that the stacktrace _must_ be formatted properly, otherwise ndk-stack will not be able to symbolicate
421-
the stacktrace. Different crash reporting tools often format stacktraces differently, so you might need to reformat the stacktrace.
422-
The stacktrace should be formatted as follows:
423-
424-
```
425-
*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
426-
#00 pc acfed libmapbox-maps.so
427-
...
428-
#12 pc 51f408 libmapbox-maps.so (BuildId: 331a309c6d4e90a8)
429-
```
430-
431-
e.g. start with asterisks line, followed by stack entries.
432-
Stack entries should start with at least one space, then a hash sign with a stack entry number,
433-
then `pc`, then the address (_without_ the `0x` prefix), then the library name.
398+
will be stripped from symbols which means that stacktraces produced are not readable. To symbolicate C++ traces, you can send them to us along with the SDK and NDK version information.
434399

435400
## Working with snapshots
436401

0 commit comments

Comments
 (0)