Skip to content

Decoding Plist Files with PropertyListDecoder

iOS Development, Swift, Property List, PropertyListDecoder2 min read

Property list files, commonly referred to as Plist files, are a popular way to store structured data in iOS applications. These files are often used to store configuration settings, user preferences, and other types of data that need to be persisted across app launches. While Plist files can be manually edited and read, iOS provides a convenient way to decode and access their contents programmatically using the PropertyListDecoder class. In this article, we will explore how to decode Plist files in iOS using PropertyListDecoder, along with some examples to help you get started.

Decoding a Plist File

To begin decoding a Plist file, we need to obtain its data. This can be done by reading the file from the app's bundle or from a specific location on the device. Once we have the data, we can use the PropertyListDecoder class to decode it into our desired data structure.

1// Example Plist file named "Config.plist"
2// {
3// "APIKey": "YOUR_API_KEY",
4// "BaseURL": ""
5// }
7struct Configuration: Codable {
8 let apiKey: String
9 let baseURL: URL
12guard let plistURL = Bundle.main.url(forResource: "Config", withExtension: "plist"),
13 let plistData = try? Data(contentsOf: plistURL) else {
14 fatalError("Unable to locate or read Plist file.")
17do {
18 let decoder = PropertyListDecoder()
19 let configuration = try decoder.decode(Configuration.self, from: plistData)
20 print("API Key: \(configuration.apiKey)")
21 print("Base URL: \(configuration.baseURL)")
22} catch {
23 print("Error decoding Plist file: \(error)")

In the above example, we define a Configuration struct that represents the structure of our Plist file. The struct conforms to the Codable protocol, allowing us to easily decode its contents using PropertyListDecoder. We retrieve the URL of the Plist file from the app's bundle and read its data into a Data object. Then, we create an instance of PropertyListDecoder and use it to decode the Plist data into our Configuration struct. Finally, we access and print the decoded values.

Decoding Arrays and Dictionaries

Plist files can also contain arrays and dictionaries, which can be easily decoded using PropertyListDecoder. Let's take a look at an example where we decode an array of strings from a Plist file.

1// Example Plist file named "Data.plist"
2// [
3// "Item 1",
4// "Item 2",
5// "Item 3"
6// ]
8guard let plistURL = Bundle.main.url(forResource: "Data", withExtension: "plist"),
9 let plistData = try? Data(contentsOf: plistURL) else {
10 fatalError("Unable to locate or read Plist file.")
13do {
14 let decoder = PropertyListDecoder()
15 let items = try decoder.decode([String].self, from: plistData)
16 print("Items: \(items)")
17} catch {
18 print("Error decoding Plist file: \(error)")

In this example, we assume that the Plist file contains an array of strings. We retrieve the URL and data of the Plist file as before. Then, we use PropertyListDecoder to decode the array of strings from the Plist data. Finally, we print the decoded items.

Similarly, if the Plist file contains a dictionary, we can decode it into a [String: Any] dictionary or any custom dictionary type that conforms to Codable.

Closing Thoughts

Decoding Plist files in iOS using PropertyListDecoder is a straightforward process that allows us to easily access and utilize the structured data stored in these files. By utilizing the power of Swift's Codable protocol and PropertyListDecoder, we can decode Plist files into our desired data types effortlessly. It can really help you with generating sample data for your app and save you a lot of time! Also remember, Property List files are a great choice for storing structured data, but always make sure to handle any sensitive information securely, such as API keys or user credentials.