Create your Gitee Account
Explore and code with more than 5 million developers,Free private repositories !:)
Sign up
这是一个通用的跨平台文件打包系统,目前支持LINUX和WINDOWS。适用于发行软件或是服务器端对第三方提供布置环境时,对自己的文件资源进行打包管理进行加密的一项重要措施。并且提供出来的文件接口很容易与现有的标准的文件系统进行替换。如标准库里的FILE对应的接口,我们已经提供了模拟。文件系统本身采用纯C语言开发,能适应各种项目和平台的平移。并且本身不做使用上的任何限制。 spread retract

Clone or download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README.md

#简介

这是一个通用的跨平台文件打包系统,目前支持LINUX和WINDOWS。  
适用于发行软件或是服务器端对第三方提供布置环境时,对自己的文件资源进行打包管理进行加密的一项重要措施。  
文件系统本身采用纯C语言开发,能适应各种项目和平台的平移。

#网址: 1.点击访问github
2.点击访问oschina

#用法说明 ##第一步:

在程序初始化的时候调用 vfs_create,并指定程序的运行目录

代码如下:

if( VFS_FALSE == vfs_create(VFS_SDK_VERSION,"workpath") )  
    return -1;  

##第二步:

加入常用的包,如果包不存在也没有关系,不存在包的时候,会优先从同名的文件文件夹里读取文件数据
当工作路径下的包不存在的时候,程序会认会这是开发模式,不会影响正常开发过程中资源频繁更换的问题。

代码如下:

vfs_add_archive("script.pak","");  
vfs_add_archive("effect.pak","");  
vfs_add_archive("a/b/c/scene.pak","");  

以上接口调用主要用来模拟文件夹,举例说明一下.
比如说 当前目录架构是这样的

workpath  
|-------/script           -> 打包之后变成script.pak  
|-------/effect           -> 打包之后变成effect.pak   
|-------/a/b/c/scene      -> 打包之后变成/a/b/c/scene.pak,如果愿意也可以对a目录进行打包,这样就是a.pak了  
                           在这里我这样举例,主要是为了介绍相对路径的概念  

开发的时候,我们用相对路径来读取数据,例如script目录中有一个_init_.lua脚本,那么我们的读取函数为

struct vfs_stream *stream = vfs_stream_open("script/_init_.lua");
if( !stream )
	return VFS_FALSE;

/* 你的读取处理 */  
vfs_stream_read(stream,buf,size,count);

/* 关闭 */  
vfs_stream_close(stream);  
stream = NULL;

当读取的时候,如果只有script目录,没有script.pak那么我们会从script目录中读取数据,这就是通常中所说的开发模式
在开发模式的时候,完全不需要对任何目录进行打包处理。
一旦程序开发完成,提测或是发版的时候,就可以对相应的目录进行打包,这个时候可以调用pack_dir对目录进行打包

*记住:每个被打包的目录,在提测或是发行的时候,需要在原来目录的同级目录,不能变更,否则发行的程序将不能正确的读取数据

##第三步:

在程序中读取文件,我们只需要用相对目录就可以了

例如:a/b/c/scene原来有一个文件map0.scene

我们写读取代码就可以这样:

struct vfs_stream *stream = vfs_stream_open("a/b/c/scene/map0.scene");
if( !stream )
	return VFS_FALSE;

/* 你的读取处理 */  
vfs_stream_read(stream,buf,size,count);

/* 关闭 */  
vfs_stream_close(stream);  
stream = NULL;

如果对scene目录进行打包,请务必将scene.pak文件还放到原来scene的目录
打包后的目录结构就变成下面这样

workpath  
|-------/script.pak  
|-------/effect.pak  
|-------/a/b/c/scene.pak  

你也可以选择将a目录打包,打包之后,目录结构是这样的:

workpath  
|-------/script.pak  
|-------/effect.pak  
|-------/a.pak  

当然 这样,你的初始化PAK的代码得改一改

原来代码如下:

vfs_add_archive("script.pak","");  
vfs_add_archive("effect.pak","");  
vfs_add_archive("a/b/c/scene.pak","");  

改后代码如下:

vfs_add_archive("script.pak","");  
vfs_add_archive("effect.pak","");  
vfs_add_archive("a.pak","");  

你的读取代码却不用做任何改变,这样即使调整目录结构,也可以很轻松随意了。

##第四步:

当程序退出的时候,我们需要调用相应的退出函数,以释放数据。

在退出的地方加上如下代码即可:

代码如下:

vfs_destroy();  

Comments ( 0 )

Sign in for post a comment