1*6dbdd20aSAndroid Build Coastguard Worker# Android Version Notes 2*6dbdd20aSAndroid Build Coastguard WorkerThis page documents all the caveats of using Perfetto on older versions of 3*6dbdd20aSAndroid Build Coastguard WorkerAndroid. Because of the yearly release cycle, it's often the case that a 4*6dbdd20aSAndroid Build Coastguard Workerfeature is shipped but we later discover a bug/problem which makes the feature 5*6dbdd20aSAndroid Build Coastguard Workernot usable or needs to be used in a very specific way. 6*6dbdd20aSAndroid Build Coastguard Worker 7*6dbdd20aSAndroid Build Coastguard Worker## U- 8*6dbdd20aSAndroid Build Coastguard Worker### New features 9*6dbdd20aSAndroid Build Coastguard Worker* The CLONE_SNAPSHOT trigger mode was introduced. 10*6dbdd20aSAndroid Build Coastguard Worker* String field filtering in traces was introduced. 11*6dbdd20aSAndroid Build Coastguard Worker 12*6dbdd20aSAndroid Build Coastguard Worker### Caveats 13*6dbdd20aSAndroid Build Coastguard Worker* On the CLONE_SNAPSHOT codepath, the trace UUID gets rewritten when the session 14*6dbdd20aSAndroid Build Coastguard Worker is clone but a statsd atom linking the two is not emitted. This means we 15*6dbdd20aSAndroid Build Coastguard Worker should be careful to exclude any "clone-only" sessions as being "failed" 16*6dbdd20aSAndroid Build Coastguard Worker sessions. 17*6dbdd20aSAndroid Build Coastguard Worker 18*6dbdd20aSAndroid Build Coastguard Worker## T- 19*6dbdd20aSAndroid Build Coastguard Worker### New features 20*6dbdd20aSAndroid Build Coastguard Worker* Reporting traces through the framework was introduced. 21*6dbdd20aSAndroid Build Coastguard Worker 22*6dbdd20aSAndroid Build Coastguard Worker### Caveats 23*6dbdd20aSAndroid Build Coastguard Worker* CLONE_SNAPSHOT does not exist in T- but there is a subtle edge case 24*6dbdd20aSAndroid Build Coastguard Worker (b/274931668) which means it's quite dangerous to specify CLONE_SNAPSHOT on 25*6dbdd20aSAndroid Build Coastguard Worker configs being sent to T- devices. 26*6dbdd20aSAndroid Build Coastguard Worker 27*6dbdd20aSAndroid Build Coastguard Worker## P 28*6dbdd20aSAndroid Build Coastguard Worker### New features 29*6dbdd20aSAndroid Build Coastguard Worker* Perfetto was included in the system image! 30*6dbdd20aSAndroid Build Coastguard Worker 31*6dbdd20aSAndroid Build Coastguard Worker### Caveats 32*6dbdd20aSAndroid Build Coastguard Worker* --txt option is not supported so configs must be binary encoded. 33