Android開發(fā)實踐：拷貝assets到sdcard

我們知道，Android工程目錄下有一個assets文件夾，它到底有什么作用呢？

網(wǎng)上關(guān)于assets文件夾與res/raw文件夾的區(qū)別的討論挺多的，也沒有一個統(tǒng)一官方的結(jié)論，到底何時用assets，何時用res/raw，這里我也來談?wù)勎业睦斫夂涂偨Y(jié)。

我認(rèn)為raw目錄畢竟是存放于res目錄下的，因此，應(yīng)該更多地把raw目錄看作是系統(tǒng)資源文件的一部分。res/raw目錄下的文件會被映射到R.java文件中，訪問的時候可以直接使用資源ID，例如：R.id.filename，并且很多Android的API都支持傳入這樣的id參數(shù)，因此我的結(jié)論是：

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

而assets該目錄可以有多層次的目錄結(jié)構(gòu)，里面的文件不會被映射到R.java中，訪問的時候需要使用AssetManager類，一般以文件流（InputStream）的形式來打開和訪問，因此，我的結(jié)論是：

該目錄下一般存放一些“非資源”類型的文件，多半是自定義或者結(jié)構(gòu)復(fù)雜的文件，比如：游戲/應(yīng)用的初始配置文件、數(shù)據(jù)庫文件、字典數(shù)據(jù)、字體文件等等。

其實，在實際的應(yīng)用中，assets目錄的文件，大都是作為應(yīng)用的初始化配置，在應(yīng)用初始安裝啟動后，拷貝到系統(tǒng)的sdcard中存儲的。

Android系統(tǒng)在sdcard上為每一個應(yīng)用分配了存儲路徑：/sdcard/Android/data/$(應(yīng)用的包路徑)，該路徑可以通過 context.getExternalFilesDir 得到，一般應(yīng)用卸載的時候，該目錄也會隨之被刪除。

關(guān)于assets目錄與res/raw目錄的區(qū)別就介紹到這，下面我給出一份我封裝好的類，提供將assets目錄下的文件按目錄結(jié)構(gòu)拷貝到sdcard的實現(xiàn)。

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類
 *  實現(xiàn)將assets下的文件按目錄結(jié)構(gòu)拷貝到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>();
		
	    //獲取系統(tǒng)在SDCard中為app分配的目錄，eg:/sdcard/Android/data/$(app's package)
	    //該目錄存放app相關(guān)的各種文件(如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;
	}
    
	/**
	 *  執(zhí)行拷貝任務(wù)
	 *  @param asset 需要拷貝的assets文件路徑
	 *  @return 拷貝成功后的目標(biāo)文件句柄
	 *  @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;
    }
}

注意，本拷貝代碼的實現(xiàn)要求assets目錄下必須有一個assets.lst文件，列出需要被拷貝到sdcard的文件列表。附件中是示例工程的代碼，工程結(jié)構(gòu)如圖所示：

    其中，assets.lst 文件內(nèi)容如下：

   map/china.txt

   map/france.txt

    示例工程中，執(zhí)行了AssetCopyer.copy之后（注意放到線程中執(zhí)行），會發(fā)現(xiàn)assets目錄下的文件被拷貝到了系統(tǒng)的/sdcard/Android/data/testassets/files目錄下了。

    關(guān)于Android的assets的拷貝就介紹到這兒了，有任何疑問歡迎留言探討，或者來信lujun.hust@gmail.com交流，或者關(guān)注我的新浪微博 @盧_俊 獲取最新的文章和資訊。