Prototyper

The Prototyper Framework allows you to integrate prototypes into an iOS application and receive feedback using Prototyper service. When you deploy an application using the Prototyper service the Prototyper Framework allows users to send feedback from within the application.

Example

Run pod install from the Example directory first and open the Prototyper Example.workspace and run the iOS application.

Requirements

To use the Prototyper framework you need an account at the Prototyper online service. To integrate a prototype into your application follow the instructions of the Prototype Framework. Your users can use the feedback button to give feedback and share the application with other users. The feedback will be displayed on the website of the Prototyper service.

Installation

1. Integrate the Prototype Framework using CocoaPods

   pod 'Prototyper'

   If you want to add prototypes to the application using the PrototypeView add the following lines at the end of your Podfile. Follow the instructions of the Prototype Framework for more details:

   post_install do |installer|
     installer.pods_project.targets.each do |target|
       target.new_shell_script_build_phase.shell_script = "mkdir -p $PODS_CONFIGURATION_BUILD_DIR/#{target.name}"
       target.build_configurations.each do |config|
         config.build_settings['CONFIGURATION_BUILD_DIR'] = '$PODS_CONFIGURATION_BUILD_DIR'
       end
     end
   
     installer.pods_project.build_configurations.each do |config|
       config.build_settings.delete('CODE_SIGNING_ALLOWED')
       config.build_settings.delete('CODE_SIGNING_REQUIRED')
     end
   end

2. Display the feedback button in the scene(: UIScene, willConnectTo: UISceneSession, options: UIScene.ConnectionOptions) method of your SceneDelegate. Don't forget to import the Prototyper framework.

   import Prototyper

   func scene(_ scene: UIScene,
              willConnectTo session: UISceneSession,
              options connectionOptions: UIScene.ConnectionOptions) {
       let contentView = ContentView()
   
       if let windowScene = scene as? UIWindowScene {
           let window = UIWindow(windowScene: windowScene)
           window.rootViewController = UIHostingController(rootView: contentView)
           self.window = window
           
           PrototyperController.showFeedbackButton = true
           
           window.makeKeyAndVisible()
       }
   }

3. Deploy your application using the Prototyper service

Author

Paul Schmiedmayer, @PSchmiedmayer, Chair of Applied Software Engineering, [email protected] Stefan Kofler, [email protected]

License

Prototyper is available under the MIT license. See the LICENSE file for more info.