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交流，或者關注我的新浪微博 @盧_俊 獲取最新的文章和資訊。