本篇文章介绍一个可以批量复制文件到指定目录的 shell 脚本。
假设这个 shell 脚本的名称为 cpfiles.sh。
在实际开发工作中，可能需要按照目录结构来保存一些改动后的文件，以作备份。
这些目录结构可能包含多个子目录、或者需要复制多个文件。
如果直接复制外面的目录，会包含没有发生改动的文件。
如果手动创建各个子目录，再来复制多个文件，比较麻烦。
当前脚本预期把要复制的文件路径保存到一个配置文件里面。
然后解析所给的配置文件，自动创建对应的子目录，复制文件到指定目录下。
当配置了多个文件路径时，就可以批量复制文件。
同时，当前脚本进行了扩展，可以处理 Android 系统的 repo status 命令打印的修改文件信息。
执行 repo status 查看 Android 源码仓库的改动时，打印的文件信息格式如下：
project frameworks/base/
-m services/core/java/com/android/server/ServiceThread.java
project packages/apps/Music/
-m src/com/android/music/MusicPicker.java在每个 project 后面，会跟着某个代码仓库相对于 Android 源码根目录的路径。
接下来的行对应该仓库下面的文件路径，这个文件路径相对于代码仓库的根目录。
例如，上面的 ServiceThread.java 文件在 Android 源码根目录中的完整路径是 “frameworks/base/services/core/java/com/android/server/ServiceThread.java”
当需要备份 Android 源码多个仓库下发生改动的文件时，可以使用 repo status 列出修改文件信息。
把这些文件信息保存到一个文件里面，当前脚本可以解析这些文件信息，批量复制所列出的文件到指定目录下。
在其他使用 git 管理代码的项目上，git log --name-status 打印的修改文件信息跟 repo status 的信息类似。
只是缺少了 “project project_path” 这一行，手动补上这一行，就可以使用当前脚本复制 git 仓库下面的文件。
脚本代码
列出 cpfiles.sh 脚本的具体代码如下所示。
在这个代码中，对大部分关键代码都提供了详细的注释，方便阅读。
这篇文章的后面也会提供一个参考的调用例子，有助理解。
#!/bin/bash
# 在Android源码中,执行repo status命令可以查看修改的文件信息.格式为:
# project frameworks/base/
# -m services/core/java/com/android/server/ServiceThread.java
# project packages/apps/Music/
# -m src/com/android/music/MusicPicker.java
# 在这些信息中,每一个 project 段对应一个代码仓库路径.当需要复制多个
# 仓库的指定代码文件时,手动复制比较麻烦. 当前脚本用于处理这种格式的
# 配置信息,组装得到完整的文件路径,并复制后指定的目标目录下.
# 同时,该脚本也做了扩展,可以提供要复制的完整文件路径,使不局限于复制
# Android 源码目录下的代码文件,可以复制任意目录下的文件.
# 下面设置set -e,一旦报错就停止执行.例如复制某个文件出错就不再复制.
set -e
show_help()
{
printf "USAGE
cpfiles.sh [source_fileinfos [target_dir]]
OPTIONS
该脚本最多可以提供两个参数. 这两个参数是可选的.
source_fileinfos: 指定保存源文件路径信息的配置文件名.
如果没有提供该参数,默认解析的文件名是 'copy-files.txt'.
target_dir: 指定要把源文件复制到哪个目录下.
如果没有提供该参数,默认会复制到当前目录下的 '0-复制后' 目录.
如果目标目录不存在,会自动新建对应的目录.
这个参数必须是第二个参数.当提供该参数时,也要提供第一个参数.
NOTE
配置源文件路径信息的参考格式如下:
project base_top_dir1/
-m file_sub_path1
project
full_file_path2
一般来说,每个 project 开头的段对应不同目录下的文件. 在project后面
可以跟着一个目录路径,该段的源文件路径会自动加上这个目录路径.例如,
在上面例子中,要复制的完整文件路径是 base_top_dir1/file_sub_path1
如果project后面没有目录路径,则该段的文件路径就是要复制的完整路径.
"
}
# 下面变量指定配置源文件路径信息的文件名.解析该文件得到要复制的文件路径.
SRC_FILEINFO="copy-files.txt"
# 这个脚本的第一个参数用于指定配置源文件路径信息的文件名.
# 如果没有提供第一个参数,则使用默认的配置文件名.
if [ $# -gt 0 ]; then
SRC_FILEINFO="$1"
fi
# 下面变量指定源文件被复制到的目标目录名,会在当前工作目录下新建该目录.
COPY_TARGET_TOP_DIR="0-复制后"
# 这个脚本的第二个参数用于指定源文件被复制到的目标目录名.
# 如果没有提供第二个参数,则使用默认的目标目录名.
if [ $# -eq 2 ]; then
COPY_TARGET_TOP_DIR="$2"
fi
if [ $# -gt 2 ]; then
echo "出错: 该脚本最多只能提供两个参数."
show_help
exit 1
fi
# 检查当前工作目录下是否存在一个指定的配置文件. 如果不存在,则报错返回.
if [ ! -f "${SRC_FILEINFO}" ]; then
echo "出错: 在当前目录下不存在要解析的 ${SRC_FILEINFO} 文件."
show_help
exit 2
fi
# 从 SRC_FILEINFO 配置文件解析出完整的源文件路径信息后,把这些信息写入到
# FULL_FILEPATH 对应的文件里面.基于FULL_FILEPATH文件保存的文件路径进行复制.
FULL_FILEPATH="full_filepaths.txt"
# 从所给文件中解析要复制的源文件路径信息.第一个参数指定被解析的文件名.
# 解析得到的完整源文件路径信息会写入 FULL_FILEPATH 变量指定的文件里面.
# 所给配置文件里面配置了要复制的源文件路径信息. 具体格式如下:
# project base_top_dir1/
# foo file_sub_path1
# project
# full_file_path2
# 配置内容可以分为多段. 每段以project开头. 每段里面可以配置多个源文件路径.
# 如果在project后面跟着一个目录路径,则该段的文件路径前面会自动加上这个目录
# 路径.例如在上面格式中,实际要复制的文件路径是 base_top_dir1/file_sub_path1.
# 此时,该段的文件路径前面要有一个 foo 占位字符串,具体内容不限,但一定要有.
# 这个格式是为了符合 Android 的 repo status 命令打印的文件信息.
# 如果project后面没有提供目录路径,表示该段的文件路径就是完整的目录路径.如果
# 所给的文件路径是相对路径,需要确保执行时的工作目录可以寻址到这个相对路径.
parse_file_infos()
{
if [ $# -ne 1 ]; then
echo "Usage: ${FUNCNAME} filename"
return 1
fi
# 所给的第一个参数指定要解析的配置文件名.
local parsefile="${1}"
# 下面变量对应每段开始的 project 字符串.
local IDENTIFY_PROJECT="project"
local fileline lastchar
local header project_dir sub_file_path full_file_path
# 如果文件的最后一行没有以换行符'\n'结尾, read 命令在读取最后一行
# 时会返回false,从而退出下面的 while 循环,导致最后一行没有被处理,
# 会少复制一个文件.下面使用 tail 命令获取文件的最后一个字符.由于
# $() 表达式会去掉输出结果末尾的换行符,如果文件的最后一个字符是换
# 行符,经过 "$()" 扩展后会变成空.可以通过判断扩展后的结果是否为空
# 来确认文件是否以换行符结尾.如果不以换行符结尾,则使用 echo 命令
# 给文件末尾追加一个换行符. test -n 命令判断字符串不为空时返回true.
if test -n "$(tail "${parsefile}" -c 1)"; then
echo >> "${parsefile}"
fi
# /dev/null 是一个空文件,输出这个文件的内容为空.重定向到
# FULL_FILEPATH 文件,清空该文件的内容,避免原有内容的影响.
cat /dev/null > "${FULL_FILEPATH}"
while read fileline; do
header="$(echo ${fileline} | awk '{print $1}')"
if [ "${header}" == "${IDENTIFY_PROJECT}" ]; then
project_dir="$(echo ${fileline} | awk '{print $2}')"
# project_dir 被作为目录路径使用,要求最后一个
# 字符必须是'/',以便组装成目录路径.如果没有
# 以 '/' 结尾,则在该变量值后面加上 '/' 字符.
if [ -n "${project_dir}" ]; then
lastchar="${project_dir: -1:1}"
if [ "${lastchar}" != "/" ]; then
project_dir="${project_dir}/"
fi
fi
elif [ -n "${fileline}" ]; then
# 当文件中有空行时, fileline 的内容是空字符串. 后面组装
# sub_file_path的值会有异常,所以上面用-n判断不为空才处理.
#
# 如果当前行没有以 project 开头,那么对应要复制的文件路径.
# 当 project_dir 不为空时,表示当前解析的段配置了目录路径,
# 那么源文件路径前面会有一个占位字符串,所以要获取空格隔开
# 的第二列内容才是文件路径. 如果 project_dir 为空,则这一
# 行就是完整的源文件路径.
if [ -n "${project_dir}" ]; then
sub_file_path="$(echo ${fileline} | awk '{print $2}')"
else
sub_file_path="${fileline}"
fi
full_file_path="${project_dir}${sub_file_path}"
echo "${full_file_path}" >> "${FULL_FILEPATH}"
fi
done < "${parsefile}"
# 由于有些文件可能被配置多次,下面对生成的内容进行排序,并删除重复行.
# sort 命令的 -u 选项表示删除重复行. -o 选项后面提供文件名来指定排序
# 后的内容要写入哪个文件. 如果没有提供 -o 选项,默认写到标准输出,不会
# 直接修改所给文件自身.这里指定排序后的内容输出到同一个文件,覆盖文件.
sort -u "${FULL_FILEPATH}" -o "${FULL_FILEPATH}"
}
# 该函数解析所给的文件,从中得到要复制的源文件路径,复制
# 指定文件到目标目录下. 所给的第一个参数指定要解析的文件名.
# 所给文件的每一行都对应一个要复制的完整文件路径.
copy_src_files()
{
if [ $# -ne 1 ]; then
echo "Usage: ${FUNCNAME} filepaths"
return 1
fi
# 所给的第一个参数指定保存了源文件完整路径信息的文件名
local copyfiles="$1"
local source_file_path
# 先创建目标目录.这个目录必须先创建, cp 命令才能复制文件过来. 当要
# 创建的目录已经存在时, mkdir 命令默认会报错.使用 -p 选项使不报错.
mkdir -pv "${COPY_TARGET_TOP_DIR}"
while read source_file_path; do
# cp 命令的 --parents 选项会在目标目录下自动创建源文件路径包含
# 的子目录.不需要先在目标目录下创建各个子目录再复制.
# cp --parents -v 命令会打印创建中间子目录的信息,导致打印的
# 信息比较多.先不加 -v 选项.使用 -u 选项指定只复制较新的文件.
cp --parents -u "${source_file_path}" "${COPY_TARGET_TOP_DIR}"
done < "$copyfiles"
}
# 把Windows系统的dos格式文件转换成unix格式. Dos格式文件的行末是\r\n,
# 而unix格式文件的行末是\n,且把\r视作有效字符.如果不做转换,那么提供
# 一个dos格式的文件,最后得到的文件路径会包含\r字符,且被当做文件名的
# 一部分.用cp命令复制时,会提示找不到这样的文件.在使用 file 命令查看
# dos 格式文件时,打印的信息包含 "CRLF line terminators" 字符串.查看
# 所给文件的信息是否包含该字符串,就可以判断这个文件是不是 dos 格式.
# 如果是 dos 格式文件,则执行 dos2unix 命令转换为 unix 格式文件.
if [[ "$(file SRC_FILEINFO)" =~ "CRLF line terminators" ]]; then
# dos2unix 命令默认直接修改所给文件自身,覆盖成 unix 格式.
dos2unix "${SRC_FILEINFO}"
fi
# 调用 parse_file_infos 函数解析所给文件内容,得到要复制的源文件路径.
# 解析得到的源文件路径保存在 FULL_FILEPATH 变量名指定的文件里面.
parse_file_infos "${SRC_FILEINFO}"
# 调用 copy_src_files 函数,基于源文件路径,复制源文件到目标目录下.
copy_src_files "${FULL_FILEPATH}"
echo "已复制全部文件到 '${COPY_TARGET_TOP_DIR}' 目录下."
# 把所给文件和生成的路径信息文件移动到目标目录下,以便记录文件来源.
cp -v "${SRC_FILEINFO}" "${COPY_TARGET_TOP_DIR}/"
mv -v "${FULL_FILEPATH}" "${COPY_TARGET_TOP_DIR}/"
exit一个参考的测试例子
为了测试当前的 cpfiles.sh 脚本，可以先执行下面命令来创建一些目录和文件：
$ mkdir -p top/sub1/left1/left2
$ mkdir -p top/sub1/right1/
$ mkdir -p top/sub2/sub3
$ touch top/sub1/left1/left2/left_file.txt
$ touch top/sub1/right1/right_file.txt
$ touch top/sub2/sub3/sub_file.txt这几个命令在当前工作目录下创建了一个 top 目录。
在这个 top 目录底下还有一些子目录和文件。总共新建了三个文本文件。
下面会使用 cpfiles.sh 脚本来复制这三个文本文件，且保存在对应的目录结构里面。
基于上面创建的目录和文件，可以新建一个 copy-files.txt 文件，并在文件里面配置如下内容：
project top/sub1/
a left1/left2/left_file.txt
a right1/right_file.txt
project
top/sub2/sub3/sub_file.txt在这个配置信息中，第一个 project 段后面跟着 top/sub1/ 目录路径。
那么该段下的文件路径会自动加上这个目录路径。
例如，所配置的 left1/left2/left_file.txt 这个文件的完整复制路径会是 “top/sub1/left1/left2/left_file.txt”。
第二个 project 段后面提供目录路径。
那么该段下的文件路径就是完整的目录路径。
此时，需要确保可以基于当前工作目录寻址到所配置的文件。
把 cpfiles.sh 脚本和 copy-files.txt 文件放到当前目录下，为脚本添加可执行权限。
具体执行结果如下：
$ ./cpfiles.sh
mkdir: created directory ‘0-复制后’
已复制全部文件到 '0-复制后' 目录下.
‘copy-files.txt’ -> ‘0-复制后/copy-files.txt’
‘full_filepaths.txt’ -> ‘0-复制后/full_filepaths.txt’
$ ls 0-复制后/
copy-files.txt full_filepaths.txt top
$ ls 0-复制后/top/
sub1 sub2可以看到，执行 cpfiles.sh 脚本后，会在当前目录新建一个 “0-复制后” 目录。
然后把所要复制的文件按照原先的目录结构复制到 “0-复制后” 目录下。
同时，还会在 “0-复制后” 目录下生成所给的 copy-files.txt 文件、生成的 full_filepaths.txt。
这两个文件记录了要复制的文件路径信息，以便后续进入该目录时，可以查看目录下的文件列表信息。
测试结束后，可以执行下面命令来删除所创建的测试目录和文件：
rm -r 0-复制后/ top/ copy-files.txt
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用。你还可以使用@来通知其他用户。