diff options
Diffstat (limited to 'documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html')
| -rw-r--r-- | documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html b/documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html new file mode 100644 index 0000000000..ebbae37990 --- /dev/null +++ b/documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html | |||
| @@ -0,0 +1,74 @@ | |||
| 1 | <html> | ||
| 2 | <head> | ||
| 3 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
| 4 | <title>3.1.3. Metadata (Virtual Providers)</title> | ||
| 5 | <link rel="stylesheet" type="text/css" href="../book.css"> | ||
| 6 | <meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> | ||
| 7 | <link rel="home" href="index.html" title="Getting Started With Yocto Project"> | ||
| 8 | <link rel="up" href="yocto-project-components.html" title="3.1. Yocto Project Components"> | ||
| 9 | <link rel="prev" href="usingpoky-components-metadata.html" title="3.1.2. Metadata (Recipes)"> | ||
| 10 | <link rel="next" href="usingpoky-components-classes.html" title="3.1.4. Classes"> | ||
| 11 | </head> | ||
| 12 | <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="section" title="3.1.3. Metadata (Virtual Providers)"> | ||
| 13 | <div class="titlepage"><div><div><h3 class="title"> | ||
| 14 | <a name="metadata-virtual-providers"></a>3.1.3. Metadata (Virtual Providers)</h3></div></div></div> | ||
| 15 | <p> | ||
| 16 | Prior to the build, if you know that several different recipes | ||
| 17 | provide the same functionality, you can use a virtual provider | ||
| 18 | (i.e. <code class="filename">virtual/*</code>) as a placeholder for the | ||
| 19 | actual provider. | ||
| 20 | The actual provider would be determined at build time. | ||
| 21 | In this case, you should add <code class="filename">virtual/*</code> | ||
| 22 | to | ||
| 23 | <a class="link" href="../ref-manual/var-DEPENDS.html" target="_self"><code class="filename">DEPENDS</code></a>, | ||
| 24 | rather than listing the specified provider. | ||
| 25 | You would select the actual provider by setting the | ||
| 26 | <a class="link" href="../ref-manual/var-PREFERRED_PROVIDER.html" target="_self"><code class="filename">PREFERRED_PROVIDER</code></a> | ||
| 27 | variable (i.e. | ||
| 28 | <code class="filename">PREFERRED_PROVIDER_virtual/*</code>) | ||
| 29 | in the build's configuration file (e.g. | ||
| 30 | <code class="filename">poky/build/conf/local.conf</code>). | ||
| 31 | </p> | ||
| 32 | <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> | ||
| 33 | <h3 class="title">Note</h3> | ||
| 34 | Any recipe that PROVIDES a <code class="filename">virtual/*</code> | ||
| 35 | item that is ultimately not selected through | ||
| 36 | <code class="filename">PREFERRED_PROVIDER</code> does not get built. | ||
| 37 | Preventing these recipes from building is usually the | ||
| 38 | desired behavior since this mechanism's purpose is to | ||
| 39 | select between mutually exclusive alternative providers. | ||
| 40 | </div> | ||
| 41 | <p> | ||
| 42 | </p> | ||
| 43 | <p> | ||
| 44 | The following lists specific examples of virtual providers: | ||
| 45 | </p> | ||
| 46 | <div class="itemizedlist"><ul class="itemizedlist" type="disc"> | ||
| 47 | <li class="listitem"><p> | ||
| 48 | <code class="filename">virtual/mesa</code>: | ||
| 49 | Provides <code class="filename">gbm.pc</code>. | ||
| 50 | </p></li> | ||
| 51 | <li class="listitem"><p> | ||
| 52 | <code class="filename">virtual/egl</code>: | ||
| 53 | Provides <code class="filename">egl.pc</code> and possibly | ||
| 54 | <code class="filename">wayland-egl.pc</code>. | ||
| 55 | </p></li> | ||
| 56 | <li class="listitem"><p> | ||
| 57 | <code class="filename">virtual/libgl</code>: | ||
| 58 | Provides <code class="filename">gl.pc</code> (i.e. libGL). | ||
| 59 | </p></li> | ||
| 60 | <li class="listitem"><p> | ||
| 61 | <code class="filename">virtual/libgles1</code>: | ||
| 62 | Provides <code class="filename">glesv1_cm.pc</code> | ||
| 63 | (i.e. libGLESv1_CM). | ||
| 64 | </p></li> | ||
| 65 | <li class="listitem"><p> | ||
| 66 | <code class="filename">virtual/libgles2</code>: | ||
| 67 | Provides <code class="filename">glesv2.pc</code> | ||
| 68 | (i.e. libGLESv2). | ||
| 69 | </p></li> | ||
| 70 | </ul></div> | ||
| 71 | <p> | ||
| 72 | </p> | ||
| 73 | </div></body> | ||
| 74 | </html> | ||