关于程序的目录结构系统(Storage System)

 在吉里吉里的体系中,关于文件(file)或者档案文件(archive)内的文件、以及其他的资源文件(resource)的叫法,并不以“文件”相称,而是称之为「storage」也就是“存储器”或者叫做“仓库”。
(U子注:这里所提到的文件(file)就是游戏在打包前的普通文件(.tjs、.ks、.jpg、.png以及各种文件夹等等),而所谓的档案文件(archive)其实就是指游戏打包后的.xp3文件。其实就是普通的文件/文件夹,只不过在吉里吉里的体系中,这些都被统称为storage了而已。在下面的叙述中,U子把这里的storage都翻译成了目录结构。 ps:好麻烦,总感觉这真的是毫无意义啊 =_=|| 总之大家将就着理解一下吧...)

统一目录结构名

 所谓统一目录结构是指:将仅能在吉里吉里内部使用的资源文件(storage)、以类似 URI 的形式表示出来。
 以格式为:media://domain/path 这样的形式书写。path间的段落分隔符为 「/ 」(正斜线) 。

本地目录结构(Local Storage)

 在表示本地目录结构时,统一目录结构名中的 media 用 file 替换、domain 用 . (点号、即半角英文句号)替换。另外,在Windows系统下,路径开头依然是要带上盘符的。

 例如,与 Windows 系统下的 C:\Program Files\Game\game.exe 相对应的统一目录结构名就以file://./c/program files/game/game.exe这样来表示。

 使用 Storages.getFullPath 方法,可以将用户操作系统(OS)中的文件名转化成以统一目录结构名的格式来表示。在进行转换的过程中,文件名中的大写字母将全部被转换为小写字母来显示(对于本地目录结构来说是不区分大小写的)。另外,本地目录结构中用于分割上下级目录的 \ 也会被转换成 / 来显示。
 Storages.getLocalName メソッドは、統一ストレージ名から OS の使うファイル名への変換を行うことができます。吉里吉里以外のアプリケーションにストレージ名を渡す場合などはこのメソッドを使用する必要があります。

アーカイブストレージ(Archive Storage)

 アーカイブ内のストレージを指定する場合は、 > で区切り、> より前をアーカイブストレージのストレージ名、> より後をアーカイブ内でのパスに指定します。

 たとえば、file://./c/program files/game/game.xp3 内の image/base.jpg というストレージならば、
file://./c/program files/game/game.xp3>image/base.jpg
 となります。
 2.19 beta 14 よりアーカイブの区切り文字が '#' から '>' に変わりました。

 吉里吉里は標準で XP3 という吉里吉里独自形式のアーカイブストレージを扱うことができます ( XPK の第3世代の形式なので XP3 )。XP3 形式のアーカイブの作成方法については Releaser を参照してください。
 XP3 アーカイブは実行可能ファイルと結合することができます。この場合は吉里吉里は実行可能ファイルを一つのアーカイブファイルとして見なすことができます ( Releaser は 吉里吉里本体との結合しかサポートしていません )。

项目目录(Project Folder)

 吉里吉里でゲームやツールなどを作る場合、必要なファイルはすべて「プロジェクトフォルダ」にまとめて開発を行うのが一般的です。吉里吉里は、起動時にプロジェクトフォルダを現在のカレントフォルダに設定します。
 プロジェクトフォルダ内の相対パスですべてを指定しておけば、Releaser で単一の実行可能ファイルなどにしてもパス指定を変える必要はありません。

数据(data)保存位置

 数据(data)的保存位置为使用 命令行选项 中的 -datapath 选项指定的目录。其值可以使用System.dataPath 属性进行获取。
 吉里吉里输出的各种日志(log)或者用户自定义的设置文件等都会输出到这里。
 同时,也推荐开发者在游戏(game)或者工具(tool)开发时,将数据(data)保存在这里。