/* * Copyright (C) 2013 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.launcher3; import com.android.launcher3.backup.BackupProtos.CheckedMessage; import com.android.launcher3.backup.BackupProtos.Favorite; import com.android.launcher3.backup.BackupProtos.Key; import com.android.launcher3.backup.BackupProtos.Journal; import com.android.launcher3.backup.BackupProtos.Resource; import com.android.launcher3.backup.BackupProtos.Screen; import com.android.launcher3.backup.BackupProtos.Widget; import com.google.protobuf.nano.InvalidProtocolBufferNanoException; import com.google.protobuf.nano.MessageNano; import java.io.BufferedInputStream; import java.io.ByteArrayOutputStream; import java.io.File; import java.io.FileInputStream; import java.io.FileNotFoundException; import java.io.FileOutputStream; import java.io.IOException; import java.lang.System; import java.util.LinkedList; import java.util.List; import java.util.zip.CRC32; import javax.xml.bind.DatatypeConverter; /** * Commandline utility for decoding Launcher3 backup protocol buffers. * *

When using com.android.internal.backup.LocalTransport, the file names are base64-encoded Key * protocol buffers with a prefix, that have been base64-encoded again by the transport: *

 *     echo "TDpDQUlnL0pxVTVnOD0=" | launcher_protoutil -k
 * 
* *

This tool understands these file names and will use the embedded Key to detect the type and * extract the payload automatically: *

 *     launcher_protoutil /tmp/TDpDQUlnL0pxVTVnOD0=
 * 
* *

With payload debugging enabled, base64-encoded protocol buffers will be written to the logs. * Copy the encoded snippet from the log, and specify the type explicitly, with the Logs flags: *

 *    echo "CAEYLiCJ9JKsDw==" | launcher_protoutil -L -k
 * 
* For backup payloads it is more convenient to copy the log snippet to a file: *
 *    launcher_protoutil -L -f favorite.log
 * 
*/ class DecoderRing { public static final String STANDARD_IN = "**stdin**"; private static Class[] TYPES = { Key.class, Favorite.class, Screen.class, Resource.class, Widget.class }; static final int ICON_TYPE_BITMAP = 1; public static void main(String[ ] args) throws Exception { Class defaultType = null; boolean extractImages = false; boolean fromLogs = false; int skip = 0; List files = new LinkedList(); boolean verbose = false; for (int i = 0; i < args.length; i++) { if ("-k".equals(args[i])) { defaultType = Key.class; } else if ("-f".equals(args[i])) { defaultType = Favorite.class; } else if ("-j".equals(args[i])) { defaultType = Journal.class; } else if ("-i".equals(args[i])) { defaultType = Resource.class; } else if ("-s".equals(args[i])) { defaultType = Screen.class; } else if ("-w".equals(args[i])) { defaultType = Widget.class; } else if ("-S".equals(args[i])) { if ((i + 1) < args.length) { skip = Integer.valueOf(args[++i]); } else { usage(args); } } else if ("-x".equals(args[i])) { extractImages = true; } else if ("-v".equals(args[i])) { verbose = true; } else if ("-L".equals(args[i])) { fromLogs = true; } else if (args[i] != null && !args[i].startsWith("-")) { files.add(new File(args[i])); } else { System.err.println("Unsupported flag: " + args[i]); usage(args); } } if (defaultType == null && files.isEmpty()) { // can't infer file type without the key usage(args); } if (files.size() > 1 && defaultType != null) { System.err.println("Explicit type ignored for multiple files."); defaultType = null; } if (files.isEmpty()) { files.add(new File(STANDARD_IN)); } for (File source : files) { Class type = null; if (defaultType == null) { Key key = decodeKey(source.getName().getBytes(), fromLogs); if (key != null) { type = TYPES[key.type]; if (verbose) { System.err.println(source.getName() + " is a " + type.getSimpleName()); System.out.println(key.toString()); } } } else { type = defaultType; } // read in the bytes ByteArrayOutputStream byteStream = new ByteArrayOutputStream(); BufferedInputStream input = null; if (source.getName() == STANDARD_IN) { input = new BufferedInputStream(System.in); } else { try { input = new BufferedInputStream(new FileInputStream(source)); } catch (FileNotFoundException e) { System.err.println("failed to open file: " + source + ", " + e); System.exit(1); } } byte[] buffer = new byte[1024]; try { while (input.available() > 0) { int n = input.read(buffer); int offset = 0; if (skip > 0) { offset = Math.min(skip, n); n -= offset; skip -= offset; } if (n > 0) { byteStream.write(buffer, offset, n); } } } catch (IOException e) { System.err.println("failed to read input: " + e); System.exit(1); } MessageNano proto = null; byte[] payload = byteStream.toByteArray(); if (type == Key.class) { proto = decodeKey(payload, fromLogs); } else if (type != null) { proto = decodeBackupData(payload, type, fromLogs); } // Generic string output if (proto != null) { System.out.println(proto.toString()); } if (extractImages) { String prefix = "stdin"; if (source != null) { prefix = source.getName(); } // save off the icon bits in a file for inspection if (proto instanceof Resource) { Resource icon = (Resource) proto; writeImageData(icon.data, prefix + ".png"); } // save off the icon bits in a file for inspection if (proto instanceof Favorite) { Favorite favorite = (Favorite) proto; if (favorite.iconType == ICON_TYPE_BITMAP) { writeImageData(favorite.icon, prefix + ".png"); } } // save off the widget icon and preview bits in files for inspection if (proto instanceof Widget) { Widget widget = (Widget) proto; if (widget.icon != null) { writeImageData(widget.icon.data, prefix + "_icon.png"); } } } } System.exit(0); } // In logcat, backup data is base64 encoded, but in localtransport files it is raw private static MessageNano decodeBackupData(byte[] payload, Class type, boolean fromLogs) throws InstantiationException, IllegalAccessException { MessageNano proto;// other types are wrapped in a checksum message CheckedMessage wrapper = new CheckedMessage(); try { if (fromLogs) { payload = DatatypeConverter.parseBase64Binary(new String(payload)); } MessageNano.mergeFrom(wrapper, payload); } catch (InvalidProtocolBufferNanoException e) { System.err.println("failed to parse wrapper: " + e); System.exit(1); } CRC32 checksum = new CRC32(); checksum.update(wrapper.payload); if (wrapper.checksum != checksum.getValue()) { System.err.println("wrapper checksum failed"); System.exit(1); } // decode the actual message proto = (MessageNano) type.newInstance(); try { MessageNano.mergeFrom(proto, wrapper.payload); } catch (InvalidProtocolBufferNanoException e) { System.err.println("failed to parse proto: " + e); System.exit(1); } return proto; } // In logcat, keys are base64 encoded with no prefix. // The localtransport adds a prefix and the base64 encodes the whole thing again. private static Key decodeKey(byte[] payload, boolean fromLogs) { Key key = new Key(); try { String encodedKey = new String(payload); if (!fromLogs) { byte[] rawKey = DatatypeConverter.parseBase64Binary(encodedKey); if (rawKey[0] != 'L' || rawKey[1] != ':') { System.err.println(encodedKey + " is not a launcher backup key."); return null; } encodedKey = new String(rawKey, 2, rawKey.length - 2); } byte[] keyProtoData = DatatypeConverter.parseBase64Binary(encodedKey); key = Key.parseFrom(keyProtoData); } catch (InvalidProtocolBufferNanoException protoException) { System.err.println("failed to extract key from filename: " + protoException); return null; } catch (IllegalArgumentException base64Exception) { System.err.println("failed to extract key from filename: " + base64Exception); return null; } // keys are self-checked if (key.checksum != checkKey(key)) { System.err.println("key ckecksum failed"); return null; } return key; } private static void writeImageData(byte[] data, String path) { FileOutputStream iconFile = null; try { iconFile = new FileOutputStream(path); iconFile.write(data); System.err.println("wrote " + path); } catch (IOException e) { System.err.println("failed to write image file: " + e); } finally { if (iconFile != null) { try { iconFile.close(); } catch (IOException e) { System.err.println("failed to close the image file: " + e); } } } } private static long checkKey(Key key) { CRC32 checksum = new CRC32(); checksum.update(key.type); checksum.update((int) (key.id & 0xffff)); checksum.update((int) ((key.id >> 32) & 0xffff)); if (key.name != null && key.name.length() > 0) { checksum.update(key.name.getBytes()); } return checksum.getValue(); } private static void usage(String[] args) { System.err.println("launcher_protoutil [-x] [-S b] [-k|-f|-i|-s|-w] [filename]"); System.err.println("\t-k\tdecode a key"); System.err.println("\t-f\tdecode a favorite"); System.err.println("\t-i\tdecode a icon"); System.err.println("\t-s\tdecode a screen"); System.err.println("\t-w\tdecode a widget"); System.err.println("\t-S b\tskip b bytes"); System.err.println("\t-x\textract image data to files"); System.err.println("\t-v\tprint key type data, as well as payload"); System.err.println("\t-l\texpect data from logcat, instead of the local transport"); System.err.println("\tfilename\tread from filename, not stdin"); System.exit(1); } }