conan-io / conan-io/docs

Improve documentation regarding cross-build

Open
#3,351 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
C++
Stars
125
Forks
382
Avg merge
22h 39m
Merged PRs (30d)
21

Description

Current documentation regarding cross-build could be improved:

- how to use current cross-compilers recipes packaged in conancenter: `android-ndk` & `emsdk` for example.
- how to write a recipe for a cross-compiler so that it can be used in a host profile and be robust to all build systems.
- how to write a custom host profile for a system installed cross-compiler without depending on a cross-compiler recipe, but something more complex that raspberry example which is too simple with its 3 env vars:
- Explain which common builldenv vars may have to be defined (`CC`, `CXX`, `AR`, `AS`, `LD`, `RANLIB`, `NM`, `STRIP`, `OBJCOPY`, `OBJDUMP`, `READELF`, `ADDR2LINE`, `ELFEDIT`, `CHOST`, `SYSROOT` etc) and conf (`tools.build:compiler_executables`, `tools.cmake.cmaketoolchain:user_toolchain`, `tools.build:sysroot`).
- Avoid mixing compiler path/name with flags in `CC` and `CXX`, prefer to define these flags in `tools.build:cflags`/`tools.build:cxxflags`, because conan may not be robust to spaces in `CC`/`CXX`/`tools.build:compiler_executables`

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.