docs-wide: remove CROPS references

The CROPS[1] project hasn't been updated in two years which makes it
incompatible with our current system requirements.

Remove references to CROPS from the documentation, and in most cases
replace them by mentioning that a container can be used (setup for it
left to the user).

Note that the project is working on reference containers[2] which may
replace this at some point (not confirmed).

[1]: https://github.com/crops/poky-container/
[2]: https://lore.kernel.org/yocto/8286fd3b-1b05-47bf-95e4-0b9f0f5411cb@app.fastmail.com/

(From yocto-docs rev: 9d795bc96ad209c1ab7c007c2aae92b60a5d6ee9)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
(cherry picked from commit 95cf1ba327a3bcdabadf0ee96d6bf38d05c4c3dc)
[AG: fix conflicts in start.rst]
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Paul Barker <paul@pbarker.dev>
This commit is contained in:
Antonin Godard
2026-07-31 10:41:36 +02:00
committed by Paul Barker
parent 8ce6b5c8c7
commit 5a83b18b4d
6 changed files with 21 additions and 148 deletions

View File

@@ -58,16 +58,12 @@ Project. Most find that it is best to have a native Linux machine
function as the development host. However, it is possible to use a
system that does not run Linux as its operating system as your
development host. When you have a Mac or Windows-based system, you can
set it up as the development host by using
`CROPS <https://github.com/crops/poky-container>`__, which leverages
`Docker Containers <https://www.docker.com/>`__. Once you take the steps
to set up a CROPS machine, you effectively have access to a shell
set it up as the development host by using an :wikipedia:`OCI container
<Open_Container_Initiative>` (using `Docker <https://www.docker.com/>`__ or
`Podman <https://podman.io/>`__). Once you take the steps
to set up container, you effectively have access to a shell
environment that is similar to what you see when using a Linux-based
development host. For the steps needed to set up a system using CROPS,
see the
":ref:`dev-manual/start:setting up to use cross platforms (crops)`"
section in
the Yocto Project Development Tasks Manual.
development host.
If your development host is going to be a system that runs a Linux
distribution, you must still take steps to prepare the system
@@ -87,7 +83,7 @@ are several ways of working in the Yocto Project environment:
which uses
BitBake, in a command-line environment from a shell on your
development host. You can accomplish this from a host that is a
native Linux machine or from a host that has been set up with CROPS.
native Linux machine or from a container.
Either way, you create, modify, and build images and applications all
within a shell-based environment using components and tools available
through your Linux distribution and the Yocto Project.

View File

@@ -285,13 +285,6 @@ Development Tools
Here are tools that help you develop images and applications using
the Yocto Project:
- *CROPS:* `CROPS <https://github.com/crops/poky-container/>`__ is an
open source, cross-platform development framework that leverages
`Docker Containers <https://www.docker.com/>`__. CROPS provides an
easily managed, extensible environment that allows you to build
binaries for a variety of architectures on Windows, Linux and Mac OS
X hosts.
- *devtool:* This command-line tool is available as part of the
extensible SDK (eSDK) and is its cornerstone. You can use ``devtool``
to help build, test, and package software within the eSDK. You can
@@ -534,9 +527,9 @@ Linux.
Build Appliance was useful as a way to try out development in the
Yocto Project environment.
#. *CROPS:* The final and best solution available now for developing
using the Yocto Project on a system not native to Linux is with
:ref:`CROPS <overview-manual/yp-intro:development tools>`.
#. *CROPS:* Used to be a solution available for developing
using the Yocto Project on a system not native to Linux (see
https://github.com/crops/poky-container).
Development Methods
===================
@@ -570,25 +563,10 @@ Build Host runs, you have several choices.
":ref:`dev-manual/start:setting up a native linux host`"
section in the Yocto Project Development Tasks Manual.
- *CROss PlatformS (CROPS):* Typically, you use
`CROPS <https://github.com/crops/poky-container/>`__, which leverages
`Docker Containers <https://www.docker.com/>`__, to set up a Build
Host that is not running Linux (e.g. Microsoft Windows or macOS).
.. note::
You can, however, use CROPS on a Linux-based system.
CROPS is an open source, cross-platform development framework that
provides an easily managed, extensible environment for building
binaries targeted for a variety of architectures on Windows, macOS,
or Linux hosts. Once the Build Host is set up using CROPS, you can
prepare a shell environment to mimic that of a shell being used on a
system natively running Linux.
For information on how to set up a Build Host with CROPS, see the
":ref:`dev-manual/start:setting up to use cross platforms (crops)`"
section in the Yocto Project Development Tasks Manual.
- *OCI Containers:* Typically, you use an :wikipedia:`OCI container
<Open_Container_Initiative>` (with `Docker <https://www.docker.com/>`__ or
`Podman <https://podman.io/>`__ for example), to set up a :term:`Build
Host` that is not running Linux (e.g. Microsoft Windows or macOS).
- *Windows Subsystem For Linux (WSL 2):* You may use Windows Subsystem
For Linux version 2 to set up a Build Host using Windows 10 or later,