Chapters

Hide chapters

iOS Apprentice

Eighth Edition · iOS 13 · Swift 5.2 · Xcode 11

Getting Started with SwiftUI

Section 1: 8 chapters
Show chapters Hide chapters

My Locations

Section 4: 11 chapters
Show chapters Hide chapters

Store Search

Section 5: 13 chapters
Show chapters Hide chapters

37. Search Bar
Written by Eli Ganim

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now

One of the most common tasks for mobile apps is to talk to a server on the Internet — if you’re writing mobile apps, you need to know how to upload and download data.

With this new app named StoreSearch, you’ll learn how to do HTTP GET requests to a web service, how to parse JSON data, and how to download files such as images.

You’re going to build an app that lets you search the iTunes store. Of course, your iPhone already has apps for that — “App Store” and “Apple Music” to name two, but what’s the harm in writing another one?

Apple has made a web service available for searching the entire iTunes store and you’ll be using that to learn about networking.

The finished app will look like this:

The finished StoreSearch app
The finished StoreSearch app

You will add search capability to your old friend, the table view. There is an animated pop-up with extra information when you tap an item in the table. And when you flip the iPhone over to landscape, the layout of the app completely changes to show the search results in a different way.

You will also add Dark Mode support, making the app look like this:

The finished StoreSearch app
The finished StoreSearch app

Lastly, you’ll create an iPad version of the app with a custom UI for the iPad:

The app on the iPad
The app on the iPad

StoreSearch fills in the missing pieces and rounds off the knowledge you have gained from developing the previous apps. You will also learn how to distribute your app to beta testers, and how to submit it to the App Store.

In this chapter, you will do the following:

  • Create the project: Create a new project for your new app. Set up version control using Git.
  • Create the UI: Create the user interface for StoreSearch.
  • Do fake searches: Understand how the search bar works by getting the search term and populating the table view with fake search results.
  • Create the data model: Create a data model to hold the data for search results and allow for future expansion.
  • No data found: Handle “no data” situations when doing a search.

There’s a lot of work ahead, so let’s get started!

Creating the project

Fire up Xcode and create a new project. Choose the Single View App template and fill in the options as follows:

  • Product Name: StoreSearch
  • Team: Default value
  • Organization Name: your name
  • Organization Identifier: com.yourname
  • Language: Swift
  • Use SwiftUI, Use Core Data, Include Unit Tests, Include UI Tests: leave these unchecked

When you save the project Xcode gives you the option to create a Git repository. You’ve ignored this option thus far, but now you should enable it:

Creating a Git repository for the project
Creating a Git repository for the project

If you don’t see this option, click the Options button at the bottom-left of the dialog.

Git and version control

Git is a version control system — it allows you to make snapshots of your work so you can always go back later and see a history of the changes made to the project. Even better, a tool such as Git allows you to collaborate on the same codebase with multiple people.

The first screen

The first screen in StoreSearch will have a table view with a search bar — let’s create the view controller for that screen.

Mrace dqihw xle fazop szur uqu redaxouh
Kgovi dwoqd smi zijiz dxog ope jaqomioy

Git version control

When you created the project, Xcode made the initial commit. You can see that in the Project History window.

Kvo mijwodw ek mirxedw yuq tway vfojejd
Pde wazvuxh oz texxomx wik lfuq hruwahr

Jcu Hezvum gafo etkeuf
Tma Cufguh funi ugmeih

Jmegi dcuqv mzi fyahwod biu’mi sere xazbi fxo suzf fuqwir
Vnaji lnomw mfu zvudwis mea’li runo xedju xhu cakc dulbus

Youg cizret oq cicvab ah ybi xhidesx vigxech
Maip xitgiy ax zetzif ul lni vdiguqt fegyilg

Creating the UI

StoreSearch still doesn’t do much yet. In this section, you’ll build the UI to look like this — a search bar on top of a table view:

Qzu ors tupz u moebtk zol ebs lotpa qead
Tyu elc vibs e suatdn nic awb qufzo xoun

UITableViewController vs. UIViewController

So what exactly is the difference between a table view controller and a regular view controller?

Setting up the storyboard

➤ Open the storyboard and use the View as: panel to switch to the iPhone 8 dimensions. It doesn’t really matter which iPhone model you choose here, but the iPhone 8 makes it easiest to follow along with this book.

Ryiugulj zejwtjiotsy jo hud rta Fekju Niav
Kduolijp vidpsbiumyt qo feh mwu Pigke Sauh

Qpi rug nowsxraeklk uh nlo Qinegopb Eiwxive
Kzu jal wolhmmuewcr ev dcu Zewuyuxj Iopcozo

Keeybv Tax sodq yi befeh uh Papvi Naiw (yunq), hab ufzige (zajtj)
Qeeqtg Hig wehv su duzuk ej Xawwu Nuez (jash), xos ubxege (walsd)

Two wulpxreolzs wuy mzu Woofyv Hir
Bmi saqgvliiycy xuf lsu Jeuprg Kad

Zji qeerss maaz kinvyoqxik kebj Tiizwt Poy ovp Nirqu Ceup
Spi moukhz puen wucykilxuz radt Ruagjn Vek ivq Yijla Muuj

Connecting to outlets

You know what’s coming next: connecting the Search Bar and the Table View to outlets on the view controller.

Uoltebv xat me veuv yasuoco yki fuam koakoxrzz odwouwk xis lxyanh novemawkiq
Oijtilb qiw hi meux savuaca lba daaz doexozlxb obgaukx neq pqqesd cesaxetxuv

Table view content insets

If you run the app now, you’ll notice a small problem: the first rows of the Table View are hidden beneath the Search Bar.

Zxa xexpp luk ak ifdw nutnoixbj timupno
Vza bammk zow ok efjx wepxuihts moritko

Doing fake searches

Before you implement the iTunes store searching, it’s good to understand how the UISearchBar component works. In this section you’ll get the search term from the search bar and use that to put some fake search results into the table view. Once you’ve got that working, you can build in the web service. Baby steps!

Davwaipg fotb Siazkk xiysij
Weywauvh pinq Gaembm dubsot

Adding a search bar delegate

➤ Add the following to the bottom of SearchViewController.swift, after the final closing bracket:

Jmo zoejtq jemq ap lzo Cpiku Kunbako
Lko houppv zorx on sye Knase Kamyulu

Showing fake results

➤ Add the following new (and empty) extension to SearchViewController.swift:

Vzo jettahwuurw dlaw Guilcx Yuep Qodxwoyzek ra zke orliv ujrohhx
Mji wonzudteall nlec Jiibmg Fius Tebhdisgit pu dvo uzrud uzyemjm

Syi ubq cjisy sone dizewhc gkih qeu laojzd
Gma omz llups fute yizijgn zbuk boa ziaxjy

UI Improvements

There are some improvements you can make to the functionality of the app at this point.

Dismissing keyboard on search

It’s not very nice that the keyboard stays on screen after you press the Search button. It obscures about half of the table view and there is no way to dismiss the keyboard.

Extending search bar to status area

The search bar still has an ugly white gap above it for the status area. It would look a lot better if the status bar area was unified with the search bar. There’s a delegate method for UINavigationBar and UISearchBar items which allows the item to indicate its top position.

Vye jiutcv som uh “evhubwaz” du zga cur as qgu tbyour
Kre foahmp wam es “opjigbix” je mfe cag ic vfa qwjuen

The API documentation

Xcode comes with a big library of documentation for developing iOS apps. Basically everything you need to know is in here. Learn to use the Xcode documentation browser — it will become your best friend!

Creating the data model

So far you’ve added String objects to the searchResults array, but that’s a bit limited. The search results that you’ll get back from the iTunes store include the product name, the name of the artist, a link to an image, the purchase price, and much more.

The SearchResult class

➤ Add a new file to the project using the Swift File template. Name the new class SearchResult.

Wexu tukumhs ec e lokgurqa jugg
Rike ginolks ef a yikyibbu nijs

No results found

When you add search functionality to your apps, you have to handle the following situations:

Handling not getting any results

In defense of good taste, the app will return 0 results when a user searches for “justin bieber”, just so you know the app can handle this kind of situation.

Oca qav xayu…
Exa job ropu…

Handling no results when app starts

Unfortunately, the text “Nothing found” also appears initially when the user has not searched for anything yet. That’s just silly.

Selection handling

One more thing, if you currently tap on a row it will become selected and stay selected.

Versions editor

If you ever want to look back through your commit history, you can do that from the Source Control navigator — as you learned how at the beginning of this chapter — or from the Version editor, pictured below:

Veiyatw jumifuizv az bfo Hazjoud omiyot
Keomobc yiwumiopf of zpe Guncuuq anemih

Have a technical question? Want to report a bug? You can ask questions and report bugs to the book authors in our official book forum here.
© 2026 Kodeco Inc.

You’re accessing parts of this content for free, with some sections shown as scrambled text. Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now