CallKit's incremental mode

In iOS 11 CallKit introduced an "incremental" mode which presumably allows the extension to add phone numbers incrementally instead of all at once. Unfortunately it's not clear how this is supposed to work and there's little to no documentation. Specifically:


* How does the app indicate that it wants to do an incremental update? CXCallDirectoryExtensionContext's isIncremental is read-only.

* If the intention is that the extension will read the isIncremental property in beginRequest and only push an incremental update in that case

a) what if the extension only has a full list here?

b) under which conditions will isIncremental be true/false?

Finally found the explanation in the header (why not in the docs???):


/**
 Whether the request should provide incremental data.

 If this is called at the beginning of the request (before any entries have been added or removed) and the result is YES,
 then the request must only provide an "incremental" set of entries, i.e. only add or remove entries relative to the last time data
 was loaded for the extension. Otherwise, if this method is not called OR is called and returns NO, then the request must provide
 a "complete" set of entries, adding the full list of entries from scratch (and removing none), regardless of whether data has ever been
 successfully loaded in the past.
 */
@property (nonatomic, readonly, getter=isIncremental) BOOL incremental API_AVAILABLE(ios(11.0));
CallKit's incremental mode
 
 
Q