包和类别 metadata.xml

项目作为维护者

第一个示例展示了一个由单个项目维护的包。它是包app-office/libreoffice的metadata.xml的简化版本。包维护者由电子邮件地址[email protected]标识，名称为Gentoo Office Project，如可选的<name>子标签中所指定。它还提供了长包描述。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pkgmetadata SYSTEM "https://gentoolinux.cn/dtd/metadata.dtd">
<pkgmetadata>
  <maintainer type="project">
    <email>[email protected]</email>
    <name>Gentoo Office Project</name>
  </maintainer>
  <longdescription>
    LibreOffice is the successor of OpenOffice.org. This ebuild
    allows you to compile it yourself. Unfortunately this compilation can
    take up to a day depending on the speed of your computer. It will
    however make a snappier LibreOffice than the binary version.
  </longdescription>
</pkgmetadata>

电子邮件地址[email protected]对应于 projects.xml中定义的Gentoo Office Project。此文件列出了Gentoo中的所有项目，它是由 项目列表（在Gentoo Wiki上提供）生成的。

<project>
  <email>[email protected]</email>
  <name>Gentoo Office Project</name>
  <url>https://wiki.gentoo.org/wiki/Project:Office</url>
  <description>
    The Office project manages the office implementations
    and related packages in Gentoo.
  </description>
  <member>
    <email>[email protected]</email>
    <name>Andreas K. Hüttel</name>
    <role>member</role>
  </member>
  <member>
    <email>[email protected]</email>
    <name>Tomáš Chvátal</name>
    <role>member</role>
  </member>
</project>

本地USE标志描述

第二个示例是根据sys-apps/portage的metadata.xml构建的。它列出了多个维护者，其中一个是开发者，另一个是项目。它说明了如何指定本地USE标志描述，并且还包含一个上游元素。还值得注意的是，在<bugs-to>标签中使用mailto:前缀，因为存在电子邮件地址而不是URL。相反，在<email>标签中指定的电子邮件地址不需要这种前缀。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pkgmetadata SYSTEM "https://gentoolinux.cn/dtd/metadata.dtd">
<pkgmetadata>
  <maintainer type="person">
    <email>[email protected]</email>
    <name>Larry the Cow</name>
  </maintainer>
  <maintainer type="project">
    <email>[email protected]</email>
  </maintainer>
  <use>
    <flag name="epydoc">Build html API documentation with epydoc.</flag>
    <flag name="ipc">Use inter-process communication between Portage and running ebuilds.</flag>
    <flag name="pypy2_0">Use pypy-c2.0 as Python interpreter.</flag>
    <flag name="python2">Use python2 as Python interpreter.</flag>
    <flag name="python3">Use python3 as Python interpreter.</flag>
    <flag name="xattr">
      Preserve extended attributes (filesystem-stored metadata) when
      installing files. Usually only required for hardened systems.
    </flag>
  </use>
  <upstream>
    <bugs-to>mailto:[email protected]</bugs-to>
    <changelog>https://gitweb.gentoo.org/proj/portage.git/plain/RELEASE-NOTES</changelog>
    <doc>https://wiki.gentoo.org/wiki/Handbook:AMD64/Working/Portage</doc>
  </upstream>
</pkgmetadata>

拆分维护权

此示例使用属性restrict根据包版本拆分维护权。根据sys-boot/grub的metadata.xml，版本2及以上的ebuild由[email protected]维护，而早期版本由Gentoo Base System项目维护。请注意在restrict中使用“>”而不是“>”。

此示例还在USE标志描述中使用了<pkg>标签。槽位依赖关系说明符不允许在<pkg>内部使用，因此采用<pkg>sys-boot/grub</pkg>:2的表示法，而不是<pkg>sys-boot/grub:2</pkg>。

最后，演示了上游描述中的<remote-id>标签。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pkgmetadata SYSTEM "https://gentoolinux.cn/dtd/metadata.dtd">
<pkgmetadata>
  <maintainer restrict="&gt;=sys-boot/grub-2" type="person">
    <email>[email protected]</email>
  </maintainer>
  <maintainer type="project">
    <email>[email protected]</email>
    <name>Gentoo Base System</name>
  </maintainer>
  <use>
    <flag name="device-mapper">
      Enable support for device-mapper from <pkg>sys-fs/lvm2</pkg>
    </flag>
    <flag name="efiemu">
      Build and install the efiemu runtimes
    </flag>
    <flag name="fonts">Build and install fonts for the gfxterm module</flag>
    <flag name="mount">
      Build and install the grub-mount utility
    </flag>
    <flag name="libzfs">
      Enable support for <pkg>sys-fs/zfs</pkg>
    </flag>
    <flag name="multislot">
      Allow concurrent installation of <pkg>sys-boot/grub</pkg>:0 and
      <pkg>sys-boot/grub</pkg>:2 by renaming all programs.
    </flag>
    <flag name="themes">Build and install GRUB themes (starfield)</flag>
    <flag name="truetype">
      Build and install grub-mkfont conversion utility
    </flag>
  </use>
  <upstream>
    <remote-id type="sourceforge">dejavu</remote-id>
  </upstream>
</pkgmetadata>

槽位和子槽位

此示例的重点是通过检查media-libs/libpng的元数据来演示如何指定槽位和子槽位。根据包的性质，可能有多种槽位的原因。对于这个特定的包，可以看出槽位用于提供不同版本的库，这些库具有不同的二进制兼容性，并且建议开发者针对槽位0进行构建。此外，根据<subslots>标签中指定的描述，具有相同子槽位的不同版本的此包提供了相同的应用程序二进制接口（ABI）。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pkgmetadata SYSTEM "https://gentoolinux.cn/dtd/metadata.dtd">
<pkgmetadata>
  <maintainer type="project">
    <email>[email protected]</email>
    <name>Gentoo Base System</name>
  </maintainer>
  <use>
    <flag name="apng">support unofficial APNG (Animated PNG) spec</flag>
  </use>
  <upstream>
    <remote-id type="cpe">cpe:/a:libpng:libpng</remote-id>
    <remote-id type="sourceforge">apng</remote-id>
  </upstream>
  <slots>
    <slot name="0">
      For building against. This is the only slot
      that provides headers and command line tools.
    </slot>
    <slot name="1.2">
      For binary compatibility, provides libpng12.so.0 only.
    </slot>
    <slot name="1.5">
      For binary compatibility, provides libpng15.so.15 only.
    </slot>
    <subslots>Reflect ABI compatibility for libpng.so.</subslots>
  </slots>
</pkgmetadata>