Tutorial/program/install/zh: Difference between revisions
imported>OCDoc Import Imported from legacy OpenComputers documentation at ocdoc.cil.li |
Clean up Markdown artifacts from DokuWiki migration |
||
| Line 1: | Line 1: | ||
= 教程:Install程序 = | = 教程:Install程序 = | ||
<code>install</code>是一个随[[openos/zh|OpenOS]]附送的软件。对于大多数用户以及大多数电脑而言,安装OpenOS的首选方法便是使用这个<code>install</code>应用。<code>install</code>的功能还包括安装本mod所提供[[Item/loot disks/zh|战利品软盘]]中的软件、运行库以及帮助脚本。 | |||
要了解有关 | 要了解有关<code>install</code>命令行选项的更多信息,我们推荐通过执行<code>man install</code>以阅读其man页面,也可以在[https://raw.githubusercontent.com/MightyPirates/OpenComputers/master-MC1.7.10/src/main/resources/assets/opencomputers/loot/openos/usr/man/install 此处](英文)阅读在线版。 | ||
<code>install</code>按以下步骤运行: | |||
* 第一步:扫描要安装的软件 | * 第一步:扫描要安装的软件 | ||
| Line 11: | Line 11: | ||
<pre>首先它会扫描可供候选的安装来源文件系统,即可以被当作安装用软件包的文件系统,例如[[:item:loot disks:zh|战利品软盘]]。如果找到了多个候选安装来源,它将会提问用户: | <pre>首先它会扫描可供候选的安装来源文件系统,即可以被当作安装用软件包的文件系统,例如[[:item:loot disks:zh|战利品软盘]]。如果找到了多个候选安装来源,它将会提问用户: | ||
</pre> | </pre> | ||
<pre> | <pre>What do you want to install?(你想安装什么?) | ||
</pre> | </pre> | ||
<pre>下面跟着它找到的可供安装的软盘列表。 | <pre>下面跟着它找到的可供安装的软盘列表。 | ||
| Line 17: | Line 17: | ||
* 第二步:扫描硬盘 | * 第二步:扫描硬盘 | ||
<pre> | <pre>下一步是扫描可供候选的安装目标文件系统,即可以作为安装的目标的文件系统,如硬盘。以从奖励箱软盘中向硬盘中安装OpenOS为例,此时的硬盘即为目标文件系统。就像候选安装来源一样,如果install找到了多个候选安装目标,它也会要求用户选择其中一个: | ||
</pre> | </pre> | ||
<pre> | <pre>Where do you want to install to?(你想安装到何处?) | ||
</pre> | </pre> | ||
<pre>下面跟着它找到的可以安装**进**的硬盘列表。 | <pre>下面跟着它找到的可以安装**进**的硬盘列表。 | ||
| Line 27: | Line 27: | ||
<pre>在继续安装之前,用户会被要求确认进行安装: | <pre>在继续安装之前,用户会被要求确认进行安装: | ||
</pre> | </pre> | ||
<pre> | <pre>Install OpenOS to /mnt/e03/? [Y/n](将OpenOS安装到/mnt/e03/?[Y/n]) | ||
</pre> | </pre> | ||
<pre>在确认了此步骤后,程序会将战利品软盘(对于此样例)中的文件复制到目标文件系统中。要安装的软件中可能会有一个可选的 | <pre>在确认了此步骤后,程序会将战利品软盘(对于此样例)中的文件复制到目标文件系统中。要安装的软件中可能会有一个可选的.prop文件,此文件可以告知install是否要设定电脑的默认启动文件系统、将其设定为什么标签(若有),以及在安装完成后是否要重启系统。 | ||
软件安装软盘还可以提供完全自定义的安装过程,只需在软盘文件系统的根目录下创建一个 | 软件安装软盘还可以提供完全自定义的安装过程,只需在软盘文件系统的根目录下创建一个.install文件。在确认安装来源与安装目标后,只要.install文件存在于安装来源文件系统,install程序就会唤起它。 | ||
</pre> | </pre> | ||
* 可选参数 | * 可选参数 | ||
<pre> | <pre>推荐你查看install的man页面以获取更详细的细节以及支持参数的完整列表。但是我考虑到有一点最好在这里提一下,战利品软盘的标签可以被用于install的参数——这样可以让搜索候选软盘时仅搜索标签一致的软盘。 | ||
</pre> | </pre> | ||
<pre> | <pre>install openos | ||
</pre> | </pre> | ||
<pre> | <pre>请注意,参数忽略大小写。在同时有多个软件安装软盘可用于安装时,以此方式指定标签可能会使得install在不询问用户的情况下减少候选项。 | ||
</pre> | </pre> | ||
== 安装额外软件 == | == 安装额外软件 == | ||
除了安装战利品软盘的软件(例如OpenOS)之外,用户还可以将 | 除了安装战利品软盘的软件(例如OpenOS)之外,用户还可以将<code>install</code>程序用于自制的软件安装软盘。如果你打算以可移动文件系统的形式提供软件,那么可以将<code>install</code>作为你的实用工具。在此文档中我们假设你以软盘的形式分发你的软件,尽管<code>install</code>不会区分文件系统组件的类型,不论是软盘、硬盘还是其他类型。 | ||
要将你的软件安装软盘与 | 要将你的软件安装软盘与<code>install</code>配合使用,最基础也是默认的方式其实是什么也不做,安装过程会凑合着进行。<code>install</code>会检查所有装有文件的文件系统,将它们全部作为安装来源的候选项。程序会要求用户选择一个以进行安装,之后<code>install</code>程序会简单地将所选软盘中的所有文件复制到所选的安装位置。这也就是OpenOS自身的安装过程。 | ||
你可以通过在你的软件发行软盘的根目录创建 | 你可以通过在你的软件发行软盘的根目录创建<code>custom.prop</code>和/或<code>custom.install</code>文件来控制<code>install</code>程序的行为。<code>.prop</code>文件应当为有效的Lua表,设定了可用于<code>install</code>的可选标记 。例如<code>openos .prop</code>文件的内容为:<code>{label = "OpenOS", reboot=true, setlabel=true, setboot=true}</code> | ||
请注意 | 请注意<code>install</code>的默认复制操作将会跳过<code>.prop</code>文件(不复制<code>.prop</code>)。 | ||
* 你可以设置自定义标签 | * 你可以设置自定义标签 | ||
<pre> | <pre>install可以将标签作为安装选项。默认情况下,install使用文件系统的标签(若未设定标签则使用其地址)。标签有助于install的运作与用户体验的提高。用户甚至可以在系统询问安装选项之前就用命令行参数告知install要安装什么。例如,如果你输入了install openos,并且还存在其他安装选项,则install只会给出OpenOS的安装选项。这使得用户可以无需经过系统询问就获取他们想要的东西。除此之外,install在列出安装选项时使用的也是同样的标签逻辑。 | ||
你可以通过定义 | 你可以通过定义.prop文件中表的label键来覆盖install程序使用的标签值。如果你想让你的用户输入install my_cool_stuff以安装你的软件,那么你需要在你的软件安装软盘根目录下创建一个.prop文件,内容为:{label="my_cool_stuff"} | ||
</pre> | </pre> | ||
* 忽略文件系统(在install中隐藏) | * 忽略文件系统(在install中隐藏) | ||
<pre> | <pre>在你有多个文件系统与软盘时使用install可能会很烦人,因为install总是会将所有磁盘都作为待选安装来源列出,因此你可能会想忽略它们。你可以创建一个内容为{ignore=true}的.prop文件,这样下次运行install时就不会将此文件系统作为安装来源列出了。 | ||
</pre> | </pre> | ||
* 自定义安装行为 | * 自定义安装行为 | ||
<pre>如果你的安装需要一套更复杂的操作,而**不只是** | <pre>如果你的安装需要一套更复杂的操作,而**不只是**复制文件(以及设定启动盘、设定标签和重启这些操作),比如说你想要限定仅复制哪些文件,以及将它们复制到什么位置(默认复制到目标文件系统的根目录)。请注意用户可以使用install命令的参数控制要复制哪个子目录到什么地方,但是可能你想让你软件的安装流程对用户提供更多的辅助,那么你需要自己配置安装步骤。 | ||
在用户将你的软件安装盘确定为安装来源后,install将会检查其中是否存在.install文件(请注意文件名开头有一个点,和.prop一样)若文件存在,install就**不会**复制任何文件,而是会将你自定义的.install文件作为脚本运行(然后就不做其他事情了)。在你的.install脚本开始运行后,你就可以完全控制如何完成安装流程了。 | |||
你自定义的 | 你自定义的.install脚本的加载环境中会提供一个有用的install表,表中包含了/bin/install程序当前接收到的选项。 \\ | ||
</pre> | </pre> | ||
例如,下面是我的自定义 | 例如,下面是我的自定义<code>.install</code>脚本,包括全部内容(是的,没别的了): <pre> | ||
for k,v in pairs(install) do | |||
io.write(k, " -> ", v) | |||
end | |||
</pre> | </pre> | ||
下面将会是输出内容(我的文件系统挂载于 | 下面将会是输出内容(我的文件系统挂载于<code>/mnt/c2b</code>,我的<code>.prop</code>文件中有<code>{label="foo"}</code>) | ||
<pre> | |||
from -> /mnt/c2b root -> label -> foo to -> // fromDir -> | |||
</pre> | |||
用户可能也会选择使用一些命令行参数,例如: | 用户可能也会选择使用一些命令行参数,例如:<code>install foo --noreboot --nosetlabel</code>。此时我也会看到这些值被传递给了我的安装脚本。 | ||
== 目录 == | == 目录 == | ||
{{:Tutorial/contents/zh}} | {{:Tutorial/contents/zh}} | ||
Latest revision as of 20:28, 24 August 2026
教程:Install程序
install是一个随OpenOS附送的软件。对于大多数用户以及大多数电脑而言,安装OpenOS的首选方法便是使用这个install应用。install的功能还包括安装本mod所提供战利品软盘中的软件、运行库以及帮助脚本。
要了解有关install命令行选项的更多信息,我们推荐通过执行man install以阅读其man页面,也可以在此处(英文)阅读在线版。
install按以下步骤运行:
- 第一步:扫描要安装的软件
首先它会扫描可供候选的安装来源文件系统,即可以被当作安装用软件包的文件系统,例如[[:item:loot disks:zh|战利品软盘]]。如果找到了多个候选安装来源,它将会提问用户:
What do you want to install?(你想安装什么?)
下面跟着它找到的可供安装的软盘列表。
- 第二步:扫描硬盘
下一步是扫描可供候选的安装目标文件系统,即可以作为安装的目标的文件系统,如硬盘。以从奖励箱软盘中向硬盘中安装OpenOS为例,此时的硬盘即为目标文件系统。就像候选安装来源一样,如果install找到了多个候选安装目标,它也会要求用户选择其中一个:
Where do you want to install to?(你想安装到何处?)
下面跟着它找到的可以安装**进**的硬盘列表。
- 第三步:安装
在继续安装之前,用户会被要求确认进行安装:
Install OpenOS to /mnt/e03/? [Y/n](将OpenOS安装到/mnt/e03/?[Y/n])
在确认了此步骤后,程序会将战利品软盘(对于此样例)中的文件复制到目标文件系统中。要安装的软件中可能会有一个可选的.prop文件,此文件可以告知install是否要设定电脑的默认启动文件系统、将其设定为什么标签(若有),以及在安装完成后是否要重启系统。 软件安装软盘还可以提供完全自定义的安装过程,只需在软盘文件系统的根目录下创建一个.install文件。在确认安装来源与安装目标后,只要.install文件存在于安装来源文件系统,install程序就会唤起它。
- 可选参数
推荐你查看install的man页面以获取更详细的细节以及支持参数的完整列表。但是我考虑到有一点最好在这里提一下,战利品软盘的标签可以被用于install的参数——这样可以让搜索候选软盘时仅搜索标签一致的软盘。
install openos
请注意,参数忽略大小写。在同时有多个软件安装软盘可用于安装时,以此方式指定标签可能会使得install在不询问用户的情况下减少候选项。
安装额外软件
除了安装战利品软盘的软件(例如OpenOS)之外,用户还可以将install程序用于自制的软件安装软盘。如果你打算以可移动文件系统的形式提供软件,那么可以将install作为你的实用工具。在此文档中我们假设你以软盘的形式分发你的软件,尽管install不会区分文件系统组件的类型,不论是软盘、硬盘还是其他类型。
要将你的软件安装软盘与install配合使用,最基础也是默认的方式其实是什么也不做,安装过程会凑合着进行。install会检查所有装有文件的文件系统,将它们全部作为安装来源的候选项。程序会要求用户选择一个以进行安装,之后install程序会简单地将所选软盘中的所有文件复制到所选的安装位置。这也就是OpenOS自身的安装过程。
你可以通过在你的软件发行软盘的根目录创建custom.prop和/或custom.install文件来控制install程序的行为。.prop文件应当为有效的Lua表,设定了可用于install的可选标记 。例如openos .prop文件的内容为:{label = "OpenOS", reboot=true, setlabel=true, setboot=true}
请注意install的默认复制操作将会跳过.prop文件(不复制.prop)。
- 你可以设置自定义标签
install可以将标签作为安装选项。默认情况下,install使用文件系统的标签(若未设定标签则使用其地址)。标签有助于install的运作与用户体验的提高。用户甚至可以在系统询问安装选项之前就用命令行参数告知install要安装什么。例如,如果你输入了install openos,并且还存在其他安装选项,则install只会给出OpenOS的安装选项。这使得用户可以无需经过系统询问就获取他们想要的东西。除此之外,install在列出安装选项时使用的也是同样的标签逻辑。
你可以通过定义.prop文件中表的label键来覆盖install程序使用的标签值。如果你想让你的用户输入install my_cool_stuff以安装你的软件,那么你需要在你的软件安装软盘根目录下创建一个.prop文件,内容为:{label="my_cool_stuff"}
- 忽略文件系统(在install中隐藏)
在你有多个文件系统与软盘时使用install可能会很烦人,因为install总是会将所有磁盘都作为待选安装来源列出,因此你可能会想忽略它们。你可以创建一个内容为{ignore=true}的.prop文件,这样下次运行install时就不会将此文件系统作为安装来源列出了。
- 自定义安装行为
如果你的安装需要一套更复杂的操作,而**不只是**复制文件(以及设定启动盘、设定标签和重启这些操作),比如说你想要限定仅复制哪些文件,以及将它们复制到什么位置(默认复制到目标文件系统的根目录)。请注意用户可以使用install命令的参数控制要复制哪个子目录到什么地方,但是可能你想让你软件的安装流程对用户提供更多的辅助,那么你需要自己配置安装步骤。 在用户将你的软件安装盘确定为安装来源后,install将会检查其中是否存在.install文件(请注意文件名开头有一个点,和.prop一样)若文件存在,install就**不会**复制任何文件,而是会将你自定义的.install文件作为脚本运行(然后就不做其他事情了)。在你的.install脚本开始运行后,你就可以完全控制如何完成安装流程了。 你自定义的.install脚本的加载环境中会提供一个有用的install表,表中包含了/bin/install程序当前接收到的选项。 \\
例如,下面是我的自定义.install脚本,包括全部内容(是的,没别的了):
for k,v in pairs(install) do io.write(k, " -> ", v) end
下面将会是输出内容(我的文件系统挂载于/mnt/c2b,我的.prop文件中有{label="foo"})
from -> /mnt/c2b root -> label -> foo to -> // fromDir ->
用户可能也会选择使用一些命令行参数,例如:install foo --noreboot --nosetlabel。此时我也会看到这些值被传递给了我的安装脚本。
目录
| < 100% 15% 15% > | |||
| 教程 | 模组特有内容 | 基础电脑 - 编写代码 - 硬盘 - Autorun与Startup自启动脚本 | |
| ::: | 模组制作 | 自定义架构 | |
| ::: | 程序 | OPPM - install | |
| ::: | 其它 | 自定义操作系统 - 中文翻译守则 |