Framework search paths (conan-io#727)

* Framework search paths

* Apple frameworks packaging

* Added changelog

Author: lasote

changelog.rst

@@ -24,6 +24,8 @@ Check https://github.com/conan-io/conan for issues and more details about develo
 - Feature: Added ``filename`` parameter to ``tools.get()`` in case it cannot be deduced from URL.
 - Feature: Propagated ``keep_permissions`` and ``pattern`` parameters from ``tools.get()`` to ``tools.unzip()``.
 - Feature: Added XZ extensions to ``unzip()``. It will only work in Python 3 with lzma support enabled, producing an error otherwise.
+- Feature: Added `FRAMEWORK_SEARCH_PATHS` var to the xcode generator to support packaging Apple Frameworks. Read more :ref:`here<package_apple_framework>`.
+
 
 1.5.2 (5-July-2018)
 --------------------

howtos/link_apple_framework.rst

@@ -36,3 +36,36 @@ frameworks if we are building an executable and ``sharedlinkflags`` will only ap
 If we are not using CMake to consume this package ``sharedlinkflags`` and ``exelinkflags`` are used indistinctly.
 In the example above we are assigning in the last line ``sharedlinkflags`` with ``exelinkflags``, so no matter what the consumer will build,
 it will indicate to the linker to link with the specified frameworks.
+
+
+.. _package_apple_framework:
+
+
+How to package Apple Frameworks
+===============================
+
+To package an Apple framework:
+
+- Copy/Create a framework folder ``XXX.framework`` (being ``XXX`` the name of your framework),
+  to your package folder, putting there all the subdirectories (``Headers``, ``Modules``, etc).
+
+.. code-block:: python
+
+    def package(self):
+        # If you have the framework folder built in your build_folder:
+        self.copy("XXX.framework/*", symlinks=True)
+        # Or build the destination folder:
+        tools.mkdir("XXX.framework/Headers")
+        self.copy("*.h", dst="XXX.framework/Headers")
+        # ...
+
+
+- Declare the framework in the ``cpp_info`` object.
+
+.. code-block:: python
+
+    def package_info(self):
+        ...
+
+        self.cpp_info.exelinkflags.append("-framework XXX")
+        self.cpp_info.sharedlinkflags = self.cpp_info.exelinkflags

reference/generators/xcode.rst

@@ -30,3 +30,5 @@ The file declare these variables:
 +--------------------------------+----------------------------------------------------------------------+
 | OTHER_CPLUSPLUSFLAGS           | The requirements cxxflags                                            |
 +--------------------------------+----------------------------------------------------------------------+
+| FRAMEWORK_SEARCH_PATHS         | The requirements root folders, so xcode can find packaged frameworks |
++--------------------------------+----------------------------------------------------------------------+