[ARROW-17753] [C++][Python][Docs] Provide instructions for "fixing" build environment issues

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 10.0.0
• Component/s: C++, Documentation, Python
• Labels: pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/32985
• Assignee: Anja Boskovic
• Reporter: Alenka Frim
• Created: 16/Sep/22 08:38
• Updated: 11/Jan/23 11:55
• Resolved: 30/Sep/22 13:28

Description

Due to bigger changes in the build workflow for Arrow C++ coming up in the 10.0.0 release, failures when building the libraries are quite common. The errors we bump into are similar to:

    CMake Error at build/dist/lib/cmake/ArrowPython/ArrowPythonConfig.cmake:61 (arrow_keep_backward_compatibility):
      Unknown CMake command "arrow_keep_backward_compatibility".
    Call Stack (most recent call first):
      CMakeLists.txt:240 (find_package)

or

-- Found Python3Alt: /Users/alenkafrim/repos/pyarrow-dev-9/bin/python  
CMake Error at /opt/homebrew/Cellar/cmake/3.24.1/share/cmake/Modules/CMakeFindDependencyMacro.cmake:47 (find_package):
  By not providing "FindArrow.cmake" in CMAKE_MODULE_PATH this project has
  asked CMake to find a package configuration file provided by "Arrow", but
  CMake did not find one.


  Could not find a package configuration file provided by "Arrow" with any of
  the following names:


    ArrowConfig.cmake
    arrow-config.cmake


  Add the installation prefix of "Arrow" to CMAKE_PREFIX_PATH or set
  "Arrow_DIR" to a directory containing one of the above files.  If "Arrow"
  provides a separate development package or SDK, be sure it has been
  installed.
Call Stack (most recent call first):
  build/dist/lib/cmake/ArrowPython/ArrowPythonConfig.cmake:54 (find_dependency)
  CMakeLists.txt:240 (find_package)

Connected issues:

• https://issues.apache.org/jira/browse/ARROW-17577
• https://issues.apache.org/jira/browse/ARROW-17575

Issue Links

• is related to: ARROW-17577 [C++][Python] CMake cannot find Arrow/Arrow Python when building PyArrow
• is related to: ARROW-17575 [C++][Docs] Update build document to follow new CMake package
• links to: GitHub Pull Request #14260