1.. SPDX-License-Identifier: CC-BY-SA-2.0-UK 2 3Using an External SCM 4********************* 5 6If you're working on a recipe that pulls from an external Source Code 7Manager (SCM), it is possible to have the OpenEmbedded build system 8notice new recipe changes added to the SCM and then build the resulting 9packages that depend on the new recipes by using the latest versions. 10This only works for SCMs from which it is possible to get a sensible 11revision number for changes. Currently, you can do this with Apache 12Subversion (SVN), Git, and Bazaar (BZR) repositories. 13 14To enable this behavior, the :term:`PV` of 15the recipe needs to include a ``+`` sign in its assignment. 16Here is an example:: 17 18 PV = "1.2.3+git" 19 20:term:`Bitbake` later includes the source control information in :term:`PKGV` 21during the packaging phase. 22 23Then, you can add the following to your 24``local.conf``:: 25 26 SRCREV:pn-PN = "${AUTOREV}" 27 28:term:`PN` is the name of the recipe for 29which you want to enable automatic source revision updating. 30 31If you do not want to update your local configuration file, you can add 32the following directly to the recipe to finish enabling the feature:: 33 34 SRCREV = "${AUTOREV}" 35 36The Yocto Project provides a distribution named ``poky-bleeding``, whose 37configuration file contains the line:: 38 39 require conf/distro/include/poky-floating-revisions.inc 40 41This line pulls in the 42listed include file that contains numerous lines of exactly that form:: 43 44 #SRCREV:pn-opkg-native ?= "${AUTOREV}" 45 #SRCREV:pn-opkg-sdk ?= "${AUTOREV}" 46 #SRCREV:pn-opkg ?= "${AUTOREV}" 47 #SRCREV:pn-opkg-utils-native ?= "${AUTOREV}" 48 #SRCREV:pn-opkg-utils ?= "${AUTOREV}" 49 SRCREV:pn-gconf-dbus ?= "${AUTOREV}" 50 SRCREV:pn-matchbox-common ?= "${AUTOREV}" 51 SRCREV:pn-matchbox-config-gtk ?= "${AUTOREV}" 52 SRCREV:pn-matchbox-desktop ?= "${AUTOREV}" 53 SRCREV:pn-matchbox-keyboard ?= "${AUTOREV}" 54 SRCREV:pn-matchbox-panel-2 ?= "${AUTOREV}" 55 SRCREV:pn-matchbox-themes-extra ?= "${AUTOREV}" 56 SRCREV:pn-matchbox-terminal ?= "${AUTOREV}" 57 SRCREV:pn-matchbox-wm ?= "${AUTOREV}" 58 SRCREV:pn-settings-daemon ?= "${AUTOREV}" 59 SRCREV:pn-screenshot ?= "${AUTOREV}" 60 . . . 61 62These lines allow you to 63experiment with building a distribution that tracks the latest 64development source for numerous packages. 65 66.. note:: 67 68 The ``poky-bleeding`` distribution is not tested on a regular basis. Keep 69 this in mind if you use it. 70 71