Android开发实践：拷贝assets到sdcard

我们知道，Android工程目录下有一个assets文件夹，它到底有什么作用呢？

网上关于assets文件夹与res/raw文件夹的区别的讨论挺多的，也没有一个统一官方的结论，到底何时用assets，何时用res/raw，这里我也来谈谈我的理解和总结。

我认为raw目录毕竟是存放于res目录下的，因此，应该更多地把raw目录看作是系统资源文件的一部分。res/raw目录下的文件会被映射到R.java文件中，访问的时候可以直接使用资源ID，例如：R.id.filename，并且很多Android的API都支持传入这样的id参数，因此我的结论是：

以“资源”的形式在Android程序中引用的文件，可以放到res/raw目录下，如声音片段，html文件，图片文件等等。

而assets该目录可以有多层次的目录结构，里面的文件不会被映射到R.java中，访问的时候需要使用AssetManager类，一般以文件流（InputStream）的形式来打开和访问，因此，我的结论是：

该目录下一般存放一些“非资源”类型的文件，多半是自定义或者结构复杂的文件，比如：游戏/应用的初始配置文件、数据库文件、字典数据、字体文件等等。

其实，在实际的应用中，assets目录的文件，大都是作为应用的初始化配置，在应用初始安装启动后，拷贝到系统的sdcard中存储的。

Android系统在sdcard上为每一个应用分配了存储路径：/sdcard/Android/data/$(应用的包路径)，该路径可以通过 context.getExternalFilesDir 得到，一般应用卸载的时候，该目录也会随之被删除。

关于assets目录与res/raw目录的区别就介绍到这，下面我给出一份我封装好的类，提供将assets目录下的文件按目录结构拷贝到sdcard的实现。

package com.ticktick.testassets;

import java.io.BufferedReader;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.util.ArrayList;
import java.util.List;

import android.content.Context;
import android.content.res.AssetManager;

/**
 *  AssetCopyer类
 *  实现将assets下的文件按目录结构拷贝到sdcard中
 *    
 *  @author ticktick
 *  @Email lujun.hust@gmail.com
 */
public class AssetCopyer {

	private static final String ASSET_LIST_FILENAME = "assets.lst";

	private final Context mContext;
	private final AssetManager mAssetManager;
	private File mAppDirectory;	
	
	public AssetCopyer( Context context ) {
            mContext = context;
            mAssetManager = context.getAssets();		
	}
		
	/**
	 *  将assets目录下指定的文件拷贝到sdcard中
	 *  @return 是否拷贝成功,true 成功；false 失败
	 *  @throws IOException
	 */
	public boolean copy() throws IOException {

	    List<String> srcFiles = new ArrayList<String>();
		
	    //获取系统在SDCard中为app分配的目录，eg:/sdcard/Android/data/$(app's package)
	    //该目录存放app相关的各种文件(如cache，配置文件等)，unstall app后该目录也会随之删除	
	    mAppDirectory = mContext.getExternalFilesDir(null);
            if (null == mAppDirectory) {
                return false;
            }
		
            //读取assets/$(subDirectory)目录下的assets.lst文件，得到需要copy的文件列表
            List<String> assets = getAssetsList(); 
            for( String asset : assets ) {        	
        	//如果不存在，则添加到copy列表
        	if( ! new File(mAppDirectory,asset).exists() ) {
        		srcFiles.add(asset);
        	}
            }        	  
        
            //依次拷贝到App的安装目录下
            for( String file : srcFiles ) {
                copy(file);
            }
		
	    return true;
	}
	
	/**
	 *  获取需要拷贝的文件列表（记录在assets/assets.lst文件中）
	 *  @return 文件列表
	 *  @throws IOException
	 */
	protected List<String> getAssetsList() throws IOException {

	    List<String> files = new ArrayList<String>();
		
	    InputStream listFile = mAssetManager.open(new File(ASSET_LIST_FILENAME).getPath());
	    BufferedReader br = new BufferedReader(new InputStreamReader(listFile));
	    String path;
            while (null != (path = br.readLine())) {
        	files.add(path);
    	    }
        
            return files;
	}
    
	/**
	 *  执行拷贝任务
	 *  @param asset 需要拷贝的assets文件路径
	 *  @return 拷贝成功后的目标文件句柄
	 *  @throws IOException
	 */
	protected File copy( String asset ) throws IOException {
		
        InputStream source = mAssetManager.open(new File(asset).getPath());
        File destinationFile = new File(mAppDirectory, asset);
        destinationFile.getParentFile().mkdirs();
        OutputStream destination = new FileOutputStream(destinationFile);
        byte[] buffer = new byte[1024];
        int nread;

        while ((nread = source.read(buffer)) != -1) {
            if (nread == 0) {
                nread = source.read();
                if (nread < 0)
                    break;
                destination.write(nread);
                continue;
            }
            destination.write(buffer, 0, nread);
        }
        destination.close();
        
        return destinationFile;
    }
}

注意，本拷贝代码的实现要求assets目录下必须有一个assets.lst文件，列出需要被拷贝到sdcard的文件列表。附件中是示例工程的代码，工程结构如图所示：

    其中，assets.lst 文件内容如下：

   map/china.txt

   map/france.txt

    示例工程中，执行了AssetCopyer.copy之后（注意放到线程中执行），会发现assets目录下的文件被拷贝到了系统的/sdcard/Android/data/testassets/files目录下了。

    关于Android的assets的拷贝就介绍到这儿了，有任何疑问欢迎留言探讨，或者来信lujun.hust@gmail.com交流，或者关注我的新浪微博 @卢_俊 获取最新的文章和资讯。