IceGig is an iOS app that shows you upcoming concerts in Iceland and lets you listen to the artist playing those shows on your Spotify account.
This project uses CocoaPods
gem install cocoapods
pod repo update
pod install
Once you installed the cocoapods you open IceGig.workspace and simply run.
The application is written in Objective-C and uses a ViewController + ViewModel paradigm (MVVM). Reactive cocoa is used for the ViewModel + View glue. The app uses simple dependency injection for singletons which are called services. ViewControllers only have outlets to UI elements, button callbacks and bindings to its ViewModel. The ViewModels use dependency injection to use the Services to do things like network requests and navigating. This makes mock writing valuable mock tests easy.
Application: Is owned and created by the AppDelegate. It creates the services, sets them up and handles the interaction between them.
LoginService: A singleton wrapper around the SPTAuth class from Spotify. Handles logging the user in to his Spotify account.
NetworkingService: A singleton wrapper around AFNetworking with a reactive API.
PlaybackService: A singleton wrapper around the SPTAudioStreamingController class from Spotify. Handles the audio playback.
RoutingService: A navigation singleton. Owns and creates the window and the navigationcontroller and handles all navigation.
Constants: A file that has the spotify app client info. If you want to create your own you update this file.
TableViewController: All the view controllers that have a table view are an instance of TableViewController. Their ViewModels adhere to the TableViewModel protocol. It handles user interaction with the table view and displaying a list of CellViewModels that are specified in its ViewModel.
TableViewModel: A protocol that all table ViewController ViewModels must adhere to. It has to specify an array of CellViewModels for the tableview to display and it has some other utility functions.
CellViewModel: A protocol that all table view cell ViewModels must adhere to. It must specify the height and reuseIdentifier of the cell.
The tests are written using XCTest and OCMock. To run the tests:
CMD + U
Releasing is done with fastlane. There is only one lane currently, release. It submits a build to apple and sends it to testflight as well. To use fastlane with the project start by installing fastlane. Then you have to create an Appfile and Deliverfile (see fastlane documentation). Then you can run:
fastlane release
- AFNetworking: A nice wrapper around making network requests.
- Reactive Cocoa : Provides a nice functional API to Objective-C. Also provides a really nice way of gluing UI and logic together.
- SDWebImage: Provides a nice API for image downloading with a built in cache.
- libextobjc: Objective-C extension library. The weakify/strongify makes not retaining self when writing Reactive Cocoa code easy.
- OCMock: A mocking library used for testing.
LoginViewController with the LoginViewModel
TableViewController with ConcertViewModel and ConcertCells
TableViewController with SongCellViewModel and SongCells
A PlayerViewController with PlayerViewModel
- The playback experience can be a lot better. Would be nice to have a scrubber and the capability to pause. Also it would be nice to be able to minimise the app while playing.
- Threading, currently networking code and cell view model allocation is run on the main thread. Would be more optimized to move that onto an offthread.
- The concert data is missing an artist name field so we search spotify from the concert title. That can sometimes include things like venue which screws up the search query. It would be great if the API would return a field with just the artists name.