Slide 1

Slide 1 text

GETTING RESOURCEFUL WITH SWIFT PACKAGE MANAGER SWIFTERS BUDAPEST | THE INTERNETS | DECEMBER 2020 ELLEN SHAPIRO | @DESIGNATEDNERD | APOLLOGRAPHQL.COM

Slide 2

Slide 2 text

No content

Slide 3

Slide 3 text

No content

Slide 4

Slide 4 text

No content

Slide 5

Slide 5 text

BUT I CAN'T USE SPM WITH XIBS, COREDATA MODELS, ASSET CATALOGS, ETC.

Slide 6

Slide 6 text

SE-271 PACKAGE MANAGER RESOURCES HTTPS://GITHUB.COM/APPLE/SWIFT-EVOLUTION/BLOB/MAIN/PROPOSALS/0271-PACKAGE-MANAGER-RESOURCES.MD

Slide 7

Slide 7 text

No content

Slide 8

Slide 8 text

A BRIEF ! DETOUR

Slide 9

Slide 9 text

HANK

Slide 10

Slide 10 text

GEORGE MICHAEL

Slide 11

Slide 11 text

HANK

Slide 12

Slide 12 text

KITTSTAGRAM APP GITHUB.COM/DESIGNATEDNERD/KITTSTAGRAM

Slide 13

Slide 13 text

No content

Slide 14

Slide 14 text

HANKBYTES LIBRARY GITHUB.COM/DESIGNATEDNERD/HANKBYTES

Slide 15

Slide 15 text

// swift-tools-version:5.3

Slide 16

Slide 16 text

targets: [ .target( name: "HankBytes", dependencies: [], resources: [ .process("Resources") ] ), .testTarget( name: "HankBytesTests", dependencies: ["HankBytes"]), ]

Slide 17

Slide 17 text

targets: [ .target( name: "HankBytes", dependencies: [], resources: [ .process("Resources") ] ), .testTarget( name: "HankBytesTests", dependencies: ["HankBytes"]), ]

Slide 18

Slide 18 text

.process

Slide 19

Slide 19 text

.process PROCESS THIS BASED ON PER-PLATFORM RULES AND OPTIMIZATIONS

Slide 20

Slide 20 text

.copy

Slide 21

Slide 21 text

.copy COPY THIS EXACTLY AS IT IS (INCLUDING DIRECTORY STRUCTURE)

Slide 22

Slide 22 text

RESOURCES ARE SCOPED PER-TARGET

Slide 23

Slide 23 text

No content

Slide 24

Slide 24 text

Bundle.module

Slide 25

Slide 25 text

Bundle.module THIS IS THE BUNDLE FOR THE CURRENT MODULE CREATED BY THE SPM TARGET

Slide 26

Slide 26 text

WITHIN YOUR LIBRARY Bundle.module.url(forResource: self.fileName, withExtension: self.fileExtension) UIImage(named: self.fileName, in: .module, compatibleWith: nil)

Slide 27

Slide 27 text

WITHIN YOUR LIBRARY Bundle.module.url(forResource: self.fileName, withExtension: self.fileExtension) UIImage(named: self.fileName, in: .module, compatibleWith: nil)

Slide 28

Slide 28 text

PUBLIC API YOUR APP CAN CONSUME public var image: UIImage? { if let image = UIImage(named: self.fileName, in: .module, compatibleWith: nil) { return image } else { guard let path = self.photoURL?.path else { return nil } return UIImage(contentsOfFile: path) } }

Slide 29

Slide 29 text

PUBLIC API YOUR APP CAN CONSUME public var image: UIImage? { if let image = UIImage(named: self.fileName, in: .module, compatibleWith: nil) { return image } else { guard let path = self.photoURL?.path else { return nil } return UIImage(contentsOfFile: path) } }

Slide 30

Slide 30 text

No content

Slide 31

Slide 31 text

LOCALIZATION

Slide 32

Slide 32 text

SE-278 PACKAGE MANAGER LOCALIZED RESOURCES HTTPS://GITHUB.COM/APPLE/SWIFT-EVOLUTION/BLOB/MAIN/PROPOSALS/0278-PACKAGE-MANAGER-LOCALIZED-RESOURCES.MD

Slide 33

Slide 33 text

No content

Slide 34

Slide 34 text

let package = Package( name: "HankBytes", defaultLocalization: "en", platforms: [ .iOS(.v14) ], products: [ .library( name: "HankBytes", targets: ["HankBytes"]), ], dependencies: [], targets: [...

Slide 35

Slide 35 text

let package = Package( name: "HankBytes", defaultLocalization: "en", platforms: [ .iOS(.v14) ], products: [ .library( name: "HankBytes", targets: ["HankBytes"]), ], dependencies: [], targets: [...

Slide 36

Slide 36 text

BASE.LPROJ

Slide 37

Slide 37 text

BASE.LPROJ ✅ Storyboards and Nibs

Slide 38

Slide 38 text

BASE.LPROJ ✅ Storyboards and Nibs " .strings files

Slide 39

Slide 39 text

USE ISO CODES English: en.lproj

Slide 40

Slide 40 text

USE ISO CODES English: en.lproj ! English: en_GB.lproj

Slide 41

Slide 41 text

USE ISO CODES English: en.lproj ! English: en_GB.lproj " English: en_US.lproj

Slide 42

Slide 42 text

No content

Slide 43

Slide 43 text

No content

Slide 44

Slide 44 text

"Avoiding unintentionally copying files not intended to be localized variants into the product"

Slide 45

Slide 45 text

DON'T COPY RESOURCES FOR UNSUPPORTED LANGUAGES

Slide 46

Slide 46 text

WHAT CAN'T YOU INCLUDE USING RESOURCES?

Slide 47

Slide 47 text

THINGS YOU DON'T WANT INCLUDED IN YOUR LIBRARY

Slide 48

Slide 48 text

BUILD SCRIPTS IN BASH OR OTHER LANGUAGES

Slide 49

Slide 49 text

No content

Slide 50

Slide 50 text

!

Slide 51

Slide 51 text

OBLIGATORY SUMMARY SLIDE

Slide 52

Slide 52 text

OBLIGATORY SUMMARY SLIDE > SPM lets you include resources used in your code in a target like images, core data models, xibs, etc.

Slide 53

Slide 53 text

OBLIGATORY SUMMARY SLIDE > SPM lets you include resources used in your code in a target like images, core data models, xibs, etc. > Resources are scoped to a particular target

Slide 54

Slide 54 text

OBLIGATORY SUMMARY SLIDE > SPM lets you include resources used in your code in a target like images, core data models, xibs, etc. > Resources are scoped to a particular target > Bundle.module auto-generated when targets declare resources

Slide 55

Slide 55 text

OBLIGATORY SUMMARY SLIDE > SPM lets you include resources used in your code in a target like images, core data models, xibs, etc. > Resources are scoped to a particular target > Bundle.module auto-generated when targets declare resources > Resources can be localized!

Slide 56

Slide 56 text

OBLIGATORY SUMMARY SLIDE > SPM lets you include resources used in your code in a target like images, core data models, xibs, etc. > Resources are scoped to a particular target > Bundle.module auto-generated when targets declare resources > Resources can be localized! > It does not let you include build helpers

Slide 57

Slide 57 text

THANK YOU!

Slide 58

Slide 58 text

APPLE LINKS > https://developer.apple.com/documentation/ swift_packages/ bundling_resources_with_a_swift_package > https://developer.apple.com/documentation/ swift_packages/ localizing_package_resources

Slide 59

Slide 59 text

NOT-APPLE LINKS > https://useyourloaf.com/blog/add- resources-to-swift-packages/ > https://medium.com/better-programming/how- to-add-resources-in-swift-package-manager- c437d44ec593