1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 3f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 4f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * you may not use this file except in compliance with the License. 6f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * You may obtain a copy of the License at 7f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 8f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 10f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * See the License for the specific language governing permissions and 14f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * limitations under the License. 15f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 16f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 17f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Access .dex (Dalvik Executable Format) files. The code here assumes that 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the DEX file has been rewritten (byte-swapped, word-aligned) and that 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the contents can be directly accessed as a collection of C arrays. Please 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * see docs/dalvik/dex-format.html for a detailed description. 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The structure and field names were chosen to match those in the DEX spec. 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * It's generally assumed that the DEX file will be stored in shared memory, 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * obviating the need to copy code and constant pool entries into newly 26f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * allocated storage. Maintaining local pointers to items in the shared area 27f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * is valid and encouraged. 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * All memory-mapped structures are 32-bit aligned unless otherwise noted. 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 31f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#ifndef _LIBDEX_CMDUTILS 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#define _LIBDEX_CMDUTILS 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* encode the result of unzipping to a file */ 35f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projecttypedef enum UnzipToFileResult { 36f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project kUTFRSuccess = 0, 3711131596dee3cf7feabd21a33d1758165fcf3794Andy McFadden kUTFRGenericFailure, 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project kUTFRBadArgs, 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project kUTFRNotZip, 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project kUTFRNoClassesDex, 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project kUTFROutputFileProblem, 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project kUTFRBadZip, 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} UnzipToFileResult; 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Map the specified DEX file, possibly after expanding it into a temp file 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * from a Jar. Pass in a MemMapping struct to hold the info. 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * This is intended for use by tools (e.g. dexdump) that need to get a 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * read-only copy of a DEX file that could be in a number of different states. 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If "tempFileName" is NULL, a default value is used. The temp file is 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * deleted after the map succeeds. 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Returns 0 on success. 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectUnzipToFileResult dexOpenAndMap(const char* fileName, const char* tempFileName, 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project MemMapping* pMap, bool quiet); 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Utility function to open a Zip archive, find "classes.dex", and extract 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * it to a file. 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectUnzipToFileResult dexUnzipToFile(const char* zipFileName, 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project const char* outFileName, bool quiet); 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 67f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#endif /*_LIBDEX_CMDUTILS*/ 68