How to add UI Automation test to existing Xcode project

Create a new project.

Add a new target by hitting the ‘+’ sign near the bottom.

Add iOS UI Testing Bundle

Edit your scheme

Confirm at testing bundle was added

Open up your test

And insert a break point

Run your test. Hit record and Xcode will record your application press.

Add accessibility to your buttons and controls like this

    let button: UIButton = {
        let button = UIButton()
        button.translatesAutoresizingMaskIntoConstraints = false
        button.backgroundColor = .green
        button.setTitle("GOT IT", for: .normal)
        button.setTitleColor(.black, for: .normal)
        button.addTarget(self, action: #selector(buttonPressed), for: .touchUpInside)

        button.accessibilityIdentifier = "gotItButton"

        return button
    }()

Sample test

    func testExample() {
        // Use recording to get started writing UI tests.
        // Use XCTAssert and related functions to verify your tests produce the correct results.

        XCUIApplication().buttons["GOT IT"].tap()
        XCTAssertTrue(XCUIApplication().buttons["gotItButton"].waitForExistence(timeout: 10))
    }

Advertisements

How to automate svg to pdf automator

My buddy Dan Drzimotta showed me a really cool way to convert any svg to pdf using the following tools.

First install the svg2pdf library.

> brew install svg2pdf

Setup Automator

Then startup automator and create the following script.

Save this (i.e. svg2pdf). Then find a svg file in your finder and convert it by right clicking on it. You will now have a pdf output into that directory.

Import into Xcode

Xcode will now scale pdfs to various resolutions. To use a pdf as an image asset drag it into your assets folder and make the following changes on the image in the inspector.

How to add navigation items to the Navigation Bar iOS

When you embed your root viewController into a NavigationController, your sub ViewControllers automatically get a title bar. But they don’t get any Nav bar items.

To add something like a Welcome button for back navigation drag out a Navigation Item

And drop it into the middle of the navbar. Same for a button. Only a NavBar button is different than a Navigation item. It looks like this.

Drag this to the upper right hand corner of the nav bar and it should be OK.

How to change which ViewController loads at startup in Storyboard

You can drag around the little arrow from one VC to the other. Or your can select the little checkbox in the menu titled ‘Is Initial View Controller’ near the top on the right hand side.

When to use Optionals in Swift

Being new to Optionals, sometimes I struggle for good examples on where and when to use them.

Here’s an example I link that show how one could use an Optional to model an AccountBalance.

struct AccountBalance {
    init(_ ledger: Money, overdraftLimit: Money? = nil) {
        self.ledger = ledger
        self.overdraftLimit = overdraftLimit
    }

    var available: Money {
        if let overdraftLimit = overdraftLimit {
            return ledger + overdraftLimit
        }
        return ledger
    }

    let ledger: Money
    let overdraftLimit: Money?
}

Both the ledger and overdraftLimit are let’s (meaning once assigned they can’t be changed). But the overdraftLimit is also an Optional because the overdraftLimit may or may not exist for this account.

I like this example because it shows how the overdraftLimit exists for some but not others. It truly is Optional. And for those who don’t have it we need some kind of check.

Building on that, here are the methods to increase/decrease the amounts of funds.

func increased(by amount: Money) -> AccountBalance {
    return AccountBalance(ledger + amount, overdraftLimit: overdraftLimit)
}

func decreased(by amount: Money) -> AccountBalance? {
    guard amount <= available else { return nil }
    return AccountBalance(ledger - amount, overdraftLimit: overdraftLimit)
}

Notice here how the AccountBalance in decreasedBy is also an Optional? This is because this operation could fail if the account does not have sufficient funds. This is a really good example of how to use a guard clause to see if something bad might happen, and then instead of throwing an error (i.e. InSufficientFunds) instead simply returning a nil when the client can guard and look for (which we will see in the next step).

We can bring it all together like this.

class Account {
init(identifier: AccountIdentifier, balance: AccountBalance) {
self.identifier = identifier
self.balance = balance
}

func credit(_ amount: Money) {
balance = balance.increased(by: amount)
}

func debit(_ amount: Money) throws {
guard let newBalance = balance.decreased(by: amount) else {
throw AccountError.insufficientBalance
}
balance = newBalance
}

let identifier: AccountIdentifier
private(set) var balance: AccountBalance
}

enum AccountError: Error {
case insufficientBalance
}

Here we can see how:

• The AccountIdentifer can be a let, but a let that dynamically builds itself based on internal properties
• The AccountBalance is a private(set) meaning no one can change its value save the AccountBalance itself
• The AccountBalance continuously creates new instances of itself, always representing itself as a Value object (safer than a reference)
• The debit method looks for that Optional if anything goes bad (much nicer than having to try catch and error). Here is simply looks for the nil (or Optional) being returned by protects itself with a guard clause at which point it decides to throw an Error

Really nice example showing a lot of the different constructs and how to use them in Swift.

Thanks to Khawer Khaliq for this great example.

How to add a custom UITableViewCell Swift

Create a new UITableViewCell in Swift (with nib)

Give it a unique identifier

Load it up in your ViewController

Then access it in your UITableView delegate methods like this

Give your cell a default height in the ViewController else you will get a warning

How to hookup UITableView Swift

Implement the protocols, get a reference to the tableView in the VC, and set yourself as the x2 delegates.

Then implement these x2 methods

Give your prototype cell a reuse identifier