debug-sim-contacts-tables.md

Debug the Sim Contacts table

If you want to take a look at the contents of Sim Contact database tables that this library uses, then use the debug module functions to print relevant columns and all rows of a particular table to the Logcat.

This is useful if you are experiencing an issue and are trying to figure out if it is this library's fault or not. This is most useful for contributors of this library. It allows us to verify that the work we are doing is correct. Consumers may also use it, especially if they are building their own full-fledged contacts application.

Context.logSimContactsTable()

This is not meant to be used in production code!

DO NOT include usages of the debug module in your production code! It is only meant to be used as a debugging tool during development!

Debug functions do not depend on the core library

Notice that the debug module does not depend on the core module, or any other modules in this project. This is done to ensure that whatever is being logged is independent of the core API implementation! This is important for debugging the core APIs during development. We wouldn't exactly want to debug the core APIs using the core APIs. That's just a recipe for disaster!

Debug functions assume that permissions have been granted

If the read permission android.permission.READ_CONTACTS is not granted, the debug functions will not print any table rows.