Home | History | Annotate | Download | only in aapt
      1 //
      2 // Copyright 2006 The Android Open Source Project
      3 //
      4 // Package assets into Zip files.
      5 //
      6 #include "Main.h"
      7 #include "AaptAssets.h"
      8 #include "ResourceTable.h"
      9 #include "ResourceFilter.h"
     10 
     11 #include <utils/Log.h>
     12 #include <utils/threads.h>
     13 #include <utils/List.h>
     14 #include <utils/Errors.h>
     15 
     16 #include <sys/types.h>
     17 #include <dirent.h>
     18 #include <ctype.h>
     19 #include <errno.h>
     20 
     21 using namespace android;
     22 
     23 static const char* kExcludeExtension = ".EXCLUDE";
     24 
     25 /* these formats are already compressed, or don't compress well */
     26 static const char* kNoCompressExt[] = {
     27     ".jpg", ".jpeg", ".png", ".gif",
     28     ".wav", ".mp2", ".mp3", ".ogg", ".aac",
     29     ".mpg", ".mpeg", ".mid", ".midi", ".smf", ".jet",
     30     ".rtttl", ".imy", ".xmf", ".mp4", ".m4a",
     31     ".m4v", ".3gp", ".3gpp", ".3g2", ".3gpp2",
     32     ".amr", ".awb", ".wma", ".wmv"
     33 };
     34 
     35 /* fwd decls, so I can write this downward */
     36 ssize_t processAssets(Bundle* bundle, ZipFile* zip, const sp<AaptAssets>& assets);
     37 ssize_t processAssets(Bundle* bundle, ZipFile* zip, const sp<AaptDir>& dir,
     38                         const AaptGroupEntry& ge, const ResourceFilter* filter);
     39 bool processFile(Bundle* bundle, ZipFile* zip,
     40                         const sp<AaptGroup>& group, const sp<AaptFile>& file);
     41 bool okayToCompress(Bundle* bundle, const String8& pathName);
     42 ssize_t processJarFiles(Bundle* bundle, ZipFile* zip);
     43 
     44 /*
     45  * The directory hierarchy looks like this:
     46  * "outputDir" and "assetRoot" are existing directories.
     47  *
     48  * On success, "bundle->numPackages" will be the number of Zip packages
     49  * we created.
     50  */
     51 status_t writeAPK(Bundle* bundle, const sp<AaptAssets>& assets,
     52                        const String8& outputFile)
     53 {
     54     #if BENCHMARK
     55     fprintf(stdout, "BENCHMARK: Starting APK Bundling \n");
     56     long startAPKTime = clock();
     57     #endif /* BENCHMARK */
     58 
     59     status_t result = NO_ERROR;
     60     ZipFile* zip = NULL;
     61     int count;
     62 
     63     //bundle->setPackageCount(0);
     64 
     65     /*
     66      * Prep the Zip archive.
     67      *
     68      * If the file already exists, fail unless "update" or "force" is set.
     69      * If "update" is set, update the contents of the existing archive.
     70      * Else, if "force" is set, remove the existing archive.
     71      */
     72     FileType fileType = getFileType(outputFile.string());
     73     if (fileType == kFileTypeNonexistent) {
     74         // okay, create it below
     75     } else if (fileType == kFileTypeRegular) {
     76         if (bundle->getUpdate()) {
     77             // okay, open it below
     78         } else if (bundle->getForce()) {
     79             if (unlink(outputFile.string()) != 0) {
     80                 fprintf(stderr, "ERROR: unable to remove '%s': %s\n", outputFile.string(),
     81                         strerror(errno));
     82                 goto bail;
     83             }
     84         } else {
     85             fprintf(stderr, "ERROR: '%s' exists (use '-f' to force overwrite)\n",
     86                     outputFile.string());
     87             goto bail;
     88         }
     89     } else {
     90         fprintf(stderr, "ERROR: '%s' exists and is not a regular file\n", outputFile.string());
     91         goto bail;
     92     }
     93 
     94     if (bundle->getVerbose()) {
     95         printf("%s '%s'\n", (fileType == kFileTypeNonexistent) ? "Creating" : "Opening",
     96                 outputFile.string());
     97     }
     98 
     99     status_t status;
    100     zip = new ZipFile;
    101     status = zip->open(outputFile.string(), ZipFile::kOpenReadWrite | ZipFile::kOpenCreate);
    102     if (status != NO_ERROR) {
    103         fprintf(stderr, "ERROR: unable to open '%s' as Zip file for writing\n",
    104                 outputFile.string());
    105         goto bail;
    106     }
    107 
    108     if (bundle->getVerbose()) {
    109         printf("Writing all files...\n");
    110     }
    111 
    112     count = processAssets(bundle, zip, assets);
    113     if (count < 0) {
    114         fprintf(stderr, "ERROR: unable to process assets while packaging '%s'\n",
    115                 outputFile.string());
    116         result = count;
    117         goto bail;
    118     }
    119 
    120     if (bundle->getVerbose()) {
    121         printf("Generated %d file%s\n", count, (count==1) ? "" : "s");
    122     }
    123 
    124     count = processJarFiles(bundle, zip);
    125     if (count < 0) {
    126         fprintf(stderr, "ERROR: unable to process jar files while packaging '%s'\n",
    127                 outputFile.string());
    128         result = count;
    129         goto bail;
    130     }
    131 
    132     if (bundle->getVerbose())
    133         printf("Included %d file%s from jar/zip files.\n", count, (count==1) ? "" : "s");
    134 
    135     result = NO_ERROR;
    136 
    137     /*
    138      * Check for cruft.  We set the "marked" flag on all entries we created
    139      * or decided not to update.  If the entry isn't already slated for
    140      * deletion, remove it now.
    141      */
    142     {
    143         if (bundle->getVerbose())
    144             printf("Checking for deleted files\n");
    145         int i, removed = 0;
    146         for (i = 0; i < zip->getNumEntries(); i++) {
    147             ZipEntry* entry = zip->getEntryByIndex(i);
    148 
    149             if (!entry->getMarked() && entry->getDeleted()) {
    150                 if (bundle->getVerbose()) {
    151                     printf("      (removing crufty '%s')\n",
    152                         entry->getFileName());
    153                 }
    154                 zip->remove(entry);
    155                 removed++;
    156             }
    157         }
    158         if (bundle->getVerbose() && removed > 0)
    159             printf("Removed %d file%s\n", removed, (removed==1) ? "" : "s");
    160     }
    161 
    162     /* tell Zip lib to process deletions and other pending changes */
    163     result = zip->flush();
    164     if (result != NO_ERROR) {
    165         fprintf(stderr, "ERROR: Zip flush failed, archive may be hosed\n");
    166         goto bail;
    167     }
    168 
    169     /* anything here? */
    170     if (zip->getNumEntries() == 0) {
    171         if (bundle->getVerbose()) {
    172             printf("Archive is empty -- removing %s\n", outputFile.getPathLeaf().string());
    173         }
    174         delete zip;        // close the file so we can remove it in Win32
    175         zip = NULL;
    176         if (unlink(outputFile.string()) != 0) {
    177             fprintf(stderr, "warning: could not unlink '%s'\n", outputFile.string());
    178         }
    179     }
    180 
    181     // If we've been asked to generate a dependency file for the .ap_ package,
    182     // do so here
    183     if (bundle->getGenDependencies()) {
    184         // The dependency file gets output to the same directory
    185         // as the specified output file with an additional .d extension.
    186         // e.g. bin/resources.ap_.d
    187         String8 dependencyFile = outputFile;
    188         dependencyFile.append(".d");
    189 
    190         FILE* fp = fopen(dependencyFile.string(), "a");
    191         // Add this file to the dependency file
    192         fprintf(fp, "%s \\\n", outputFile.string());
    193         fclose(fp);
    194     }
    195 
    196     assert(result == NO_ERROR);
    197 
    198 bail:
    199     delete zip;        // must close before remove in Win32
    200     if (result != NO_ERROR) {
    201         if (bundle->getVerbose()) {
    202             printf("Removing %s due to earlier failures\n", outputFile.string());
    203         }
    204         if (unlink(outputFile.string()) != 0) {
    205             fprintf(stderr, "warning: could not unlink '%s'\n", outputFile.string());
    206         }
    207     }
    208 
    209     if (result == NO_ERROR && bundle->getVerbose())
    210         printf("Done!\n");
    211 
    212     #if BENCHMARK
    213     fprintf(stdout, "BENCHMARK: End APK Bundling. Time Elapsed: %f ms \n",(clock() - startAPKTime)/1000.0);
    214     #endif /* BENCHMARK */
    215     return result;
    216 }
    217 
    218 ssize_t processAssets(Bundle* bundle, ZipFile* zip,
    219                       const sp<AaptAssets>& assets)
    220 {
    221     ResourceFilter filter;
    222     status_t status = filter.parse(bundle->getConfigurations());
    223     if (status != NO_ERROR) {
    224         return -1;
    225     }
    226 
    227     ssize_t count = 0;
    228 
    229     const size_t N = assets->getGroupEntries().size();
    230     for (size_t i=0; i<N; i++) {
    231         const AaptGroupEntry& ge = assets->getGroupEntries()[i];
    232 
    233         ssize_t res = processAssets(bundle, zip, assets, ge, &filter);
    234         if (res < 0) {
    235             return res;
    236         }
    237 
    238         count += res;
    239     }
    240 
    241     return count;
    242 }
    243 
    244 ssize_t processAssets(Bundle* bundle, ZipFile* zip, const sp<AaptDir>& dir,
    245         const AaptGroupEntry& ge, const ResourceFilter* filter)
    246 {
    247     ssize_t count = 0;
    248 
    249     const size_t ND = dir->getDirs().size();
    250     size_t i;
    251     for (i=0; i<ND; i++) {
    252         const sp<AaptDir>& subDir = dir->getDirs().valueAt(i);
    253 
    254         const bool filterable = filter != NULL && subDir->getLeaf().find("mipmap-") != 0;
    255 
    256         if (filterable && subDir->getLeaf() != subDir->getPath() && !filter->match(ge.toParams())) {
    257             continue;
    258         }
    259 
    260         ssize_t res = processAssets(bundle, zip, subDir, ge, filterable ? filter : NULL);
    261         if (res < 0) {
    262             return res;
    263         }
    264         count += res;
    265     }
    266 
    267     if (filter != NULL && !filter->match(ge.toParams())) {
    268         return count;
    269     }
    270 
    271     const size_t NF = dir->getFiles().size();
    272     for (i=0; i<NF; i++) {
    273         sp<AaptGroup> gp = dir->getFiles().valueAt(i);
    274         ssize_t fi = gp->getFiles().indexOfKey(ge);
    275         if (fi >= 0) {
    276             sp<AaptFile> fl = gp->getFiles().valueAt(fi);
    277             if (!processFile(bundle, zip, gp, fl)) {
    278                 return UNKNOWN_ERROR;
    279             }
    280             count++;
    281         }
    282     }
    283 
    284     return count;
    285 }
    286 
    287 /*
    288  * Process a regular file, adding it to the archive if appropriate.
    289  *
    290  * If we're in "update" mode, and the file already exists in the archive,
    291  * delete the existing entry before adding the new one.
    292  */
    293 bool processFile(Bundle* bundle, ZipFile* zip,
    294                  const sp<AaptGroup>& group, const sp<AaptFile>& file)
    295 {
    296     const bool hasData = file->hasData();
    297 
    298     String8 storageName(group->getPath());
    299     storageName.convertToResPath();
    300     ZipEntry* entry;
    301     bool fromGzip = false;
    302     status_t result;
    303 
    304     /*
    305      * See if the filename ends in ".EXCLUDE".  We can't use
    306      * String8::getPathExtension() because the length of what it considers
    307      * to be an extension is capped.
    308      *
    309      * The Asset Manager doesn't check for ".EXCLUDE" in Zip archives,
    310      * so there's no value in adding them (and it makes life easier on
    311      * the AssetManager lib if we don't).
    312      *
    313      * NOTE: this restriction has been removed.  If you're in this code, you
    314      * should clean this up, but I'm in here getting rid of Path Name, and I
    315      * don't want to make other potentially breaking changes --joeo
    316      */
    317     int fileNameLen = storageName.length();
    318     int excludeExtensionLen = strlen(kExcludeExtension);
    319     if (fileNameLen > excludeExtensionLen
    320             && (0 == strcmp(storageName.string() + (fileNameLen - excludeExtensionLen),
    321                             kExcludeExtension))) {
    322         fprintf(stderr, "warning: '%s' not added to Zip\n", storageName.string());
    323         return true;
    324     }
    325 
    326     if (strcasecmp(storageName.getPathExtension().string(), ".gz") == 0) {
    327         fromGzip = true;
    328         storageName = storageName.getBasePath();
    329     }
    330 
    331     if (bundle->getUpdate()) {
    332         entry = zip->getEntryByName(storageName.string());
    333         if (entry != NULL) {
    334             /* file already exists in archive; there can be only one */
    335             if (entry->getMarked()) {
    336                 fprintf(stderr,
    337                         "ERROR: '%s' exists twice (check for with & w/o '.gz'?)\n",
    338                         file->getPrintableSource().string());
    339                 return false;
    340             }
    341             if (!hasData) {
    342                 const String8& srcName = file->getSourceFile();
    343                 time_t fileModWhen;
    344                 fileModWhen = getFileModDate(srcName.string());
    345                 if (fileModWhen == (time_t) -1) { // file existence tested earlier,
    346                     return false;                 //  not expecting an error here
    347                 }
    348 
    349                 if (fileModWhen > entry->getModWhen()) {
    350                     // mark as deleted so add() will succeed
    351                     if (bundle->getVerbose()) {
    352                         printf("      (removing old '%s')\n", storageName.string());
    353                     }
    354 
    355                     zip->remove(entry);
    356                 } else {
    357                     // version in archive is newer
    358                     if (bundle->getVerbose()) {
    359                         printf("      (not updating '%s')\n", storageName.string());
    360                     }
    361                     entry->setMarked(true);
    362                     return true;
    363                 }
    364             } else {
    365                 // Generated files are always replaced.
    366                 zip->remove(entry);
    367             }
    368         }
    369     }
    370 
    371     //android_setMinPriority(NULL, ANDROID_LOG_VERBOSE);
    372 
    373     if (fromGzip) {
    374         result = zip->addGzip(file->getSourceFile().string(), storageName.string(), &entry);
    375     } else if (!hasData) {
    376         /* don't compress certain files, e.g. PNGs */
    377         int compressionMethod = bundle->getCompressionMethod();
    378         if (!okayToCompress(bundle, storageName)) {
    379             compressionMethod = ZipEntry::kCompressStored;
    380         }
    381         result = zip->add(file->getSourceFile().string(), storageName.string(), compressionMethod,
    382                             &entry);
    383     } else {
    384         result = zip->add(file->getData(), file->getSize(), storageName.string(),
    385                            file->getCompressionMethod(), &entry);
    386     }
    387     if (result == NO_ERROR) {
    388         if (bundle->getVerbose()) {
    389             printf("      '%s'%s", storageName.string(), fromGzip ? " (from .gz)" : "");
    390             if (entry->getCompressionMethod() == ZipEntry::kCompressStored) {
    391                 printf(" (not compressed)\n");
    392             } else {
    393                 printf(" (compressed %d%%)\n", calcPercent(entry->getUncompressedLen(),
    394                             entry->getCompressedLen()));
    395             }
    396         }
    397         entry->setMarked(true);
    398     } else {
    399         if (result == ALREADY_EXISTS) {
    400             fprintf(stderr, "      Unable to add '%s': file already in archive (try '-u'?)\n",
    401                     file->getPrintableSource().string());
    402         } else {
    403             fprintf(stderr, "      Unable to add '%s': Zip add failed\n",
    404                     file->getPrintableSource().string());
    405         }
    406         return false;
    407     }
    408 
    409     return true;
    410 }
    411 
    412 /*
    413  * Determine whether or not we want to try to compress this file based
    414  * on the file extension.
    415  */
    416 bool okayToCompress(Bundle* bundle, const String8& pathName)
    417 {
    418     String8 ext = pathName.getPathExtension();
    419     int i;
    420 
    421     if (ext.length() == 0)
    422         return true;
    423 
    424     for (i = 0; i < NELEM(kNoCompressExt); i++) {
    425         if (strcasecmp(ext.string(), kNoCompressExt[i]) == 0)
    426             return false;
    427     }
    428 
    429     const android::Vector<const char*>& others(bundle->getNoCompressExtensions());
    430     for (i = 0; i < (int)others.size(); i++) {
    431         const char* str = others[i];
    432         int pos = pathName.length() - strlen(str);
    433         if (pos < 0) {
    434             continue;
    435         }
    436         const char* path = pathName.string();
    437         if (strcasecmp(path + pos, str) == 0) {
    438             return false;
    439         }
    440     }
    441 
    442     return true;
    443 }
    444 
    445 bool endsWith(const char* haystack, const char* needle)
    446 {
    447     size_t a = strlen(haystack);
    448     size_t b = strlen(needle);
    449     if (a < b) return false;
    450     return strcasecmp(haystack+(a-b), needle) == 0;
    451 }
    452 
    453 ssize_t processJarFile(ZipFile* jar, ZipFile* out)
    454 {
    455     status_t err;
    456     size_t N = jar->getNumEntries();
    457     size_t count = 0;
    458     for (size_t i=0; i<N; i++) {
    459         ZipEntry* entry = jar->getEntryByIndex(i);
    460         const char* storageName = entry->getFileName();
    461         if (endsWith(storageName, ".class")) {
    462             int compressionMethod = entry->getCompressionMethod();
    463             size_t size = entry->getUncompressedLen();
    464             const void* data = jar->uncompress(entry);
    465             if (data == NULL) {
    466                 fprintf(stderr, "ERROR: unable to uncompress entry '%s'\n",
    467                     storageName);
    468                 return -1;
    469             }
    470             out->add(data, size, storageName, compressionMethod, NULL);
    471             free((void*)data);
    472         }
    473         count++;
    474     }
    475     return count;
    476 }
    477 
    478 ssize_t processJarFiles(Bundle* bundle, ZipFile* zip)
    479 {
    480     status_t err;
    481     ssize_t count = 0;
    482     const android::Vector<const char*>& jars = bundle->getJarFiles();
    483 
    484     size_t N = jars.size();
    485     for (size_t i=0; i<N; i++) {
    486         ZipFile jar;
    487         err = jar.open(jars[i], ZipFile::kOpenReadOnly);
    488         if (err != 0) {
    489             fprintf(stderr, "ERROR: unable to open '%s' as a zip file: %d\n",
    490                 jars[i], err);
    491             return err;
    492         }
    493         err += processJarFile(&jar, zip);
    494         if (err < 0) {
    495             fprintf(stderr, "ERROR: unable to process '%s'\n", jars[i]);
    496             return err;
    497         }
    498         count += err;
    499     }
    500 
    501     return count;
    502 }
    503