Difference between revisions of "Zh/Documentation/DevGuide/Extensions/Target Platform"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (New page: {{Documentation/DevGuide/ExtensionsTOC/Zh |ShowPrevNext=block |PrevPage=Zh/Documentation/DevGuide/Extensions/Extension Versions |NextPage=Zh/Documentation/DevGuide/Extensions/Simple Licens...)
 
m
Line 6: Line 6:
 
[[en:Documentation/DevGuide/Extensions/Target Platform]]
 
[[en:Documentation/DevGuide/Extensions/Target Platform]]
 
{{DISPLAYTITLE:目标平台}}
 
{{DISPLAYTITLE:目标平台}}
 +
 
[自 OOo 3.0 起]
 
[自 OOo 3.0 起]
−
It is possible to determine a target platform for an extension by providing a platform tag in the [[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/platform|platform ]] tag in the [[Documentation/DevGuide/Extensions/Description of XML Elements|description.xml]].
+
可以使用 [[Zh/Documentation/DevGuide/Extensions/Description of XML Elements|description.xml]] 中的 [[Zh/Documentation/DevGuide/Extensions/Description of XML Elements#/description/platform 元素|平台]] 标签来确定一个扩展的目标平台。
  
−
'''Please notice''' that this platform tag is '''ONLY''' used during installation in order to see if the user's platform is usable.
 
−
It is NOT used for identifying an extension. Please read the [[Documentation/DevGuide/Extensions/Extension Identifiers|identifier documentation]] for details.
 
  
−
If the platform is not present then it is assumed that all platforms are suitable. This corresponds to explicitly specifying all platforms:
+
'''请注意''' 这个平台标签'''只'''在安装过程中使用以确定用户使用何种平台。这无法用来识别扩展，详见 [[Zh/Documentation/DevGuide/Extensions/Extension Identifiers|标识符文档]]。
 +
 
 +
 
 +
如果没有平台标签，那么就默认为所有平台适用。这与显示注明所有平台适用是一样的：
 
<source lang="xml">
 
<source lang="xml">
 
<platform value="all" />
 
<platform value="all" />
 
</source>
 
</source>
  
−
The attribute value may contain one to many platform tokens separated by commas:
+
 
 +
属性值可以包含多个平台标记，由逗号分隔：
 
<source lang="xml">
 
<source lang="xml">
 
<platform value="windows_x86,linux_x86,solaris_sparc" />
 
<platform value="windows_x86,linux_x86,solaris_sparc" />
 
</source>
 
</source>
  
−
An extension can only be installed if one of the provided platform tokens matches the user's platform. The special 'all' platform represents all platforms. That is, the extension can be installed everywhere. Whereas
+
 
 +
只有在用户平台与其中一个平台标签相匹配时才能安装扩展。特殊的“all"平台表示所有平台。也就是说，这个扩展可以安装在所有平台上。相反的
 
<source lang="xml">
 
<source lang="xml">
 
<platform value=" " />
 
<platform value=" " />
 
</source>
 
</source>
  
−
would prevent installation on all platforms.
+
将防止在所有平台安装。
 +
 
  
−
The tokens need to be defined by OOo. Every token can represent a particular platform constellation. The currently defined tokens are listed in the paragraph [[Documentation/DevGuide/Extensions/Target Platform#Platform Tokens| Platform Tokens ]]
+
平台标签（Flatform token）需要由 OOo 来定义。每个标签可以表示一个特定的平台集。当前已定义的标签在[[Zh/Documentation/DevGuide/Extensions/Target Platform#Platform Tokens| 平台标签]]章节列出。
  
 
Do not confuse these tokens with those used to specify a native library in the  [[Documentation/DevGuide/Extensions/File Format#Shared Library UNO Components for particular Platforms |manifest.xml]]. We will unify the use of the tokens in one of the future releases.
 
Do not confuse these tokens with those used to specify a native library in the  [[Documentation/DevGuide/Extensions/File Format#Shared Library UNO Components for particular Platforms |manifest.xml]]. We will unify the use of the tokens in one of the future releases.

Revision as of 08:23, 20 October 2008


[自 OOo 3.0 起] 可以使用 description.xml 中的 平台 标签来确定一个扩展的目标平台。


请注意 这个平台标签只在安装过程中使用以确定用户使用何种平台。这无法用来识别扩展，详见 标识符文档。


如果没有平台标签，那么就默认为所有平台适用。这与显示注明所有平台适用是一样的： 

<platform value="all" />


属性值可以包含多个平台标记，由逗号分隔： 

<platform value="windows_x86,linux_x86,solaris_sparc" />


只有在用户平台与其中一个平台标签相匹配时才能安装扩展。特殊的“all"平台表示所有平台。也就是说，这个扩展可以安装在所有平台上。相反的 

<platform value=" " />

将防止在所有平台安装。


平台标签（Flatform token）需要由 OOo 来定义。每个标签可以表示一个特定的平台集。当前已定义的标签在 平台标签章节列出。

Do not confuse these tokens with those used to specify a native library in the manifest.xml. We will unify the use of the tokens in one of the future releases.

Platform Tokens

Token Description
all Represents all platforms.
freebsd_x86 FreeBSD operating system running on x86 compatible CPU.
freebsd_x86_64 FreeBSD operating system running on x86 compatible 64bit CPU.
linux_arm_eabi (Not yet supported) Linux operating system running on ARM CPU using 'EABI'.
linux_arm_oabi (Not yet supported) Linux operating system running on ARM CPU using 'OABI'.
linux_ia64 Linux operating system running on a ia64 CPU.
linux_mips_eb (Not yet supported) Linux operating system running on a MIPS CPU using 'EB' ABI.
linux_mips_el (Not yet supported) Linux operating system running on a MIPS CPU using 'EL' ABI.
linux_powerpc Linux operating system running on a POWERPC CPU.
linux_powerpc64 (Not yet supported) Linux operating system running on a POWERPC 64bit CPU.
linux_s390 Linux operating system running on a s390 CPU.
linux_s390x (Not yet supported) Linux operating system running on a s390x CPU.
linux_sparc Linux operating system running on a SPARC CPU.
linux_x86 Linux operating system running on a x86 CPU.
linux_x86_64 Linux operating system running on a x86 64 bit CPU.
macosx_powerpc Mac X operating system running on a POWERPC CPU.
macosx_x86 Mac X operating system running on a x86 CPU.
os2_x86 OS/2 operating system running on a x86 CPU.
solaris_sparc Solaris operating system running on a SPARC CPU.
solaris_x86 Solaris operating system running on a x86 CPU.
windows_x86 Windows operating system running on a x86 CPU.

The tokens with the description 'Not yet supported' will be supported at a later time (see issue 88578).

Backward Compatibility of Platforms

Often an OOo built for 32bit platform will run on the respective 64bit platform as well. In this case the platform element would only need the value of the 32bit platform. The reason is, that the extension manager compares the platform of the extension with the platform for which OOo was built. Here are some examples:

Extension platform OOo build for platform Platform where OOo runs Result
Linux_x86 Linux_x86 Linux_x86 ok
Linux_x86 Linux_x86 Linux_x86_64 ok
Linux_x86 Linux_x86_64 Linux_x86_64 fails
Linux_x86_64 Linux_x86 Linux_x86_64 fails


Generating the Platform String in the Build Environment

When it is necessary to generate the description.xml and the platform string during in the build process one can utilize the rtlbootstrap.mk which is contained in the inc folder. rtlbootstrap.mk is build in module sal and contains values for the operating system and processor. For example: 

RTL_OS:=Linux
RTL_ARCH:=x86

These values correspond to the values of the bootstrap variable ${_OS} and ${_ARCH}. The file can be included in the makefile which generates the description.xml and use 

PLATFORMSTRING = $(RTL_OS:l)_$(RTL_ARCH:l)

to form the string.


See also


Content on this page is licensed under the Public Documentation License (PDL).
Retrieved from "https://wiki.openoffice.org/w/index.php?title=Zh/Documentation/DevGuide/Extensions/Target_Platform&oldid=96228"
Personal tools
In other languages