Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/GEOSwift/geos
GEOS packaging for SPM & CocoaPods
https://github.com/GEOSwift/geos
cocoapods geos swift-pm
Last synced: about 2 months ago
JSON representation
GEOS packaging for SPM & CocoaPods
- Host: GitHub
- URL: https://github.com/GEOSwift/geos
- Owner: GEOSwift
- License: gpl-2.0
- Created: 2017-10-04T23:50:52.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2023-05-08T00:33:40.000Z (over 1 year ago)
- Last Synced: 2024-07-05T09:37:59.199Z (3 months ago)
- Topics: cocoapods, geos, swift-pm
- Language: C++
- Homepage:
- Size: 3.29 MB
- Stars: 12
- Watchers: 4
- Forks: 22
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GEOS
[](https://swift.org/package-manager/)
[](https://cocoapods.org)
[](https://github.com/GEOSwift/geos)
[](https://github.com/GEOSwift/geos/actions/workflows/main.yml)
GEOS is an open source C++ library for working with geospatial geometry. Learn
more on its [homepage](https://libgeos.org). This repo makes its C interface
available through Swift Package Manager and CocoaPods so you can use
it in your Swift or Objective-C project. It is commonly used via
[GEOSwift](https://github.com/GEOSwift/GEOSwift).
## Requirements
* iOS 9.0+, macOS 10.9+, tvOS 9.0+, watchOS 2.0+ (Swift Package Manager, CocoaPods)
* Linux (Swift Package Manager)
> GEOS is licensed under LGPL 2.1 and its compatibility with static linking is
at least controversial. Use of geos without dynamic linking is discouraged.
## Upstream Version
GEOSwift/geos 8.1.0 packages [libgeos/geos](https://github.com/libgeos/geos) 3.11.2
## Installing with CocoaPods
1. Update your `Podfile` to include:
use_frameworks!
pod 'geos'
2. Run `$ pod install`
## Installing with Swift Package Manager
1. Update the top-level dependencies in your `Package.swift` to include:
.package(url: "https://github.com/GEOSwift/geos.git", from: "8.1.0")
2. Update the target dependencies in your `Package.swift` to include
"geos"
## History
Starting with tag 3.7.0 in this repo, the Podspec here should match the one in
the CocoaPods specs repo. This has not always been the case. For example, the
3.5.0 tag in this repo does not actually represent what you get if you install
3.5.0 from CocoaPods. Alas, this situation should be remedied as we move
forward.
Version 3.7.0 is based on the actually-published 3.5.0 podspec.
Through version 3.7.1, the version numbers in this repo were designed to match
the corresponding version numbers in GEOS itself. Starting with version 4.0.0,
we are breaking with this pattern and will instead use semantic versioning on
this build configuration itself rather than trying to match the underlying geos
version. This allows us more flexibilty to improve the build config
independently of the geos release cycle.
## License
The build configurations provided in this repo are licensed under the GPL 2.0.
See [LICENSE](LICENSE) for full details.
The contents of the Sources directory are taken from the GEOS project which is
licensed under the LGPL 2.1. See [Sources/COPYING](Sources/COPYING) for full
details.
## Developing
The most common development activity is updating to a new version of GEOS. To
get started:
1. Install cmake: `$ brew install cmake`
2. Modify `update.sh` to indicate the version of GEOS that you wish to use.
3. Run `update.sh`
4. Debug any issues. The script may need to be modified to work with newer
versions of the library. Please keep it up-to-date so that we have a record of
how to get from the GEOS source to the end result in this repo.
5. Update `Package.swift` and `geos.podspec` to ensure
continued support for Swift Package Manager and CocoaPods.
6. Test all your changes on the full matrix of supported configs
(Swift Package Manager, CocoaPods) x (iOS, macOS, tvOS, watchOS) + Swift
Package Manager x Linux.
7. Update the version numbers in `geos.podspec` and `README.md`
8. Update this README with any relevant information.