STPhotoMap - iOS
STPhotoMap 是一个针对 iOS 的框架,可以在本地地图 MKMapView
上显示来自 Streetography 的照片。
屏幕截图
要求
- iOS 11.0+ / macOS 10.10+ / tvOS 9.0+ / watchOS 2.0+
- Xcode 10.0+
依赖项
安装
依赖管理器
CocoaPods
CocoaPods 是 Cocoa 项目的依赖管理器。您可以使用以下命令安装它:
$ gem install cocoapods
要使用 CocoaPods 将 STPhotoMap 集成到您的 Xcode 项目中,请在您的 Podfile
中指定它。
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!
pod 'STPhotoMap', '~> 0.1.4'
然后,运行以下命令:
$ pod install
Carthage
Carthage 是一个去中心化的依赖管理器,它自动将框架添加到您的 Cocoa 应用程序中。
您可以使用以下命令使用 Homebrew 安装 Carthage:
$ brew update
$ brew install carthage
要使用 Carthage 将 STPhotoMap 集成到您的 Xcode 项目中,请在您的 Cartfile
中指定它。
github "mikelanza/st-photo-map-ios" ~> 0.1.4
Swift 包管理器
要使用 STPhotoMap 作为 Swift 包管理器 包,只需在您的 Package.swift
文件中添加以下内容。
// swift-tools-version:4.2
import PackageDescription
let package = Package(
name: "HelloSTPhotoMap",
dependencies: [
.package(url: "https://github.com/mikelanza/st-photo-map-ios.git", .upToNextMajor(from: "0.1.4"))
],
targets: [
.target(name: "HelloSTPhotoMap", dependencies: ["STPhotoMap"])
]
)
手动方式
如果您不希望使用上述任一依赖管理器,可以手动将 STPhotoMap 集成到项目中。
Git 子模块
- 打开终端,进入您的顶级项目目录,如果您的项目尚未初始化为 git 仓库,则运行以下命令:
$ git init
- 通过运行以下命令将 STPhotoMap 添加为 git 子模块:
$ git submodule add https://github.com/mikelanza/st-photo-map-ios.git
$ git submodule update --init --recursive
-
打开新的
STPhotoMap
文件夹,并将STPhotoMap.xcodeproj
拖动到您的应用 Xcode 项目的 Project Navigator 中。它应该位于您的应用蓝色项目图标下方。它是否在所有其他 Xcode 组之上或之下并不重要。
-
在 Project Navigator 中选择
STPhotoMap.xcodeproj
,以验证其部署目标与您的应用目标匹配。 -
接下来,在 Project Navigator 中选择您的应用项目(蓝色项目图标),进入目标配置窗口,并在侧边栏的“Targets”选项下选择应用目标。
-
在该窗口顶部的标签栏中,打开“General”面板。
-
在“Embedded Binaries”部分下点击
+
按钮。 -
您将看到两个不同的
STPhotoMap.xcodeproj
文件夹,每个文件夹内部都包含一个STPhotoMap.framework
版本的版本,位于一个Products
文件夹中。您可以选择任意的
Products
文件夹。 -
选择
STPhotoMap.framework
。 -
完成!
STPhotoMap.framework
将自动作为目标依赖项添加,在拷贝文件构建阶段链接并嵌入,这是您在模拟器和设备上构建所需的所有内容。
嵌入式二进制文件
- 从 https://github.com/mikelanza/st-photo-map-ios/releases 下载最新版本。
- 接下来,在 Project Navigator 中选择您的应用项目(蓝色项目图标),进入目标配置窗口,并在侧边栏的“Targets”选项下选择应用目标。
- 在该窗口顶部的标签栏中,打开“General”面板。
- 在“Embedded Binaries”部分下点击
+
按钮。 - 添加下载的
STPhotoMap.framework
。 - 完成!
使用方法
请参见STPhotoMap - iOS Example项目了解使用。
问题
∙ 从iOS 13开始,自定义瓦片渲染器STPhotoTileOverlayRenderer
无法正确显示地图上的图像瓦片。需要修复此问题。
贡献
欢迎提交问题和Pull Request!
作者
许可证
STPhotoMap以MIT许可证发布。请参阅LICENSE以获取详细信息。