TPPDF: A Swift repository from shawn736

TPPDF is a fast PDF builder for iOS using simple commands to create advanced documents!

What's new? Features • Communication • Example • Usage • Installation • Credits • License

Attention:

We just released version 2.0.0. It has breaking API changes and might causes issues as it is needs more testing. Please do not upgrade to it yet, unless you are willing to accept some instability.

IF YOU SEE ANY ISSUES, PLEASE REPORT THEM! Thank you!

What's new?

TPPDF 2.0 brings a lot of new features and small tweaks. Here are some of the biggest ones:

Swift Package Manager Support
Table with cell merging
Table cell content wraps on page breaks
Hyperlinks in attributed strings
Native progress tracking using Foundation.Progress
Instance-based generators, so you can generate multiple documents at the same time

Features

Communication

If you need help, use Stack Overflow. (Tag 'TPPDF')
If you'd like to ask a general question, use Stack Overflow.
If you found a bug, open an issue.
If you have a feature request, open an issue.
If you want to contribute, submit a pull request.

Example

To run the example project, run pod try TPPDF

Installation

Requirements

As of TPPDF 2.0 and Swift 5.2, we do not actively support older Swift versions anymore. If you still need an older Swift version, see the following table for their respective branches. Bleed development version can be found on the develop branch.

Language	Branch	Pod version	Xcode version	iOS version
Swift 4.2	swift-4.2	>= 1.3.x	Xcode 10.0+	iOS 8.3+
Swift 4.1	swift-4.1	>= 1.0.x	Xcode 9.3	iOS 8.3+
Swift 3.0	swift-3.0	>= 0.2.x	Xcode 8	iOS 8.0+
Swift 2.3	swift-2.3	0.1.5	Xcode 8, Xcode 7.3.x	iOS 8.0+
Swift 2.2	swift-2.2	0.1.4	Xcode 7.3.x	iOS 8.0+

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate TPPDF into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://cdn.cocoapods.org/'
platform :ios, '10.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'TPPDF'
end

Then, run the following command:

$ pod install

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate TPPDF into your Xcode project using Carthage, specify it in your Cartfile:

github "techprimate/TPPDF" ~> 1.4

Run carthage update to build the framework and drag the built TPPDF.framework into your Xcode project

Swift Package Manager

Swift Package Manager is now supported for iOS. macOS support is a requested feature and work-in-progress.

Linux support is not available, as UIKit is not available on linux.

Once you have your Swift package set up, adding TPPDF as a dependency is as easy as adding it to the dependencies value of your Package.swift.

dependencies: [
    .package(url: "https://github.com/techprimate/TPPDF", .upToNextMajor(from: "2.0.0"))
]

Manual Installation

As Xcode project configurations are getting pretty complex, it is recommended to use a dependency manager. If you still want to add TPPDF manually, please see issue #97.

Apps using TPPDF

If you are using TPPDF in your app and want to be listed here, simply create a pull request or let me know on twitter or via github. I am always curious who is using my projects :)

ChatHistory - by techprimate