xcoder 0.1.4 → 0.1.6

data/.gitignore

@@ -1,8 +1,23 @@
-*.gem
+
+# Dependency management
+
 .bundle
 Gemfile.lock
+
+# Documentation
+
+.yardoc
+doc/
+
+# Gem creation and packaging
+
 pkg/*
+*.gem
+
+# Tests and Test Related Files
+
 spec/TestProject/TestProject.xcodeproj/xcuserdata
 spec/TestProject/TestProject.xcodeproj/project.xcworkspace/
 spec/TestProject/build
-spec/test-reports
+spec/test-reports
+

data/README.md

@@ -1,6 +1,8 @@
 # XCoder
 
-A ruby wrapper around various xcode tools and project, schemes and workspace configuration files
+Taking the pain out of scripting and automating xcode builds.
+
+Xcoder is a ruby wrapper around various Xcode tools as well as providing project and workspace parsing and partial write support.  Xcoder also supports manipulation of keychains, packaging and uploading artifacts to [Testflight](http://testflightapp.com) and provisioning profile management.
 
 Full documentation can be found here: http://rayh.github.com/xcoder/
 
@@ -111,9 +113,9 @@ Or enumerate installed profiles:
 		p.uninstall		# Removes the profile from ~/Library/
 	end
 
-### Testflight
+### [Testflight](http://testflightapp.com)
 
-The common output of this build/package process is to upload to testflight.  This is pretty simple with xcoder:
+The common output of this build/package process is to upload to Testflight.  This is pretty simple with Xcoder:
 
 	builder.testflight(API_TOKEN, TEAM_TOKEN) do |tf|
 	  tf.notes = "some release notes"
@@ -133,6 +135,64 @@ You can invoke your test target/bundle from the builder
 	
 This will invoke the test target, capture the output and write the junit reports to the test-reports directory.  Currently only junit is supported.
 
+## Manipulating a Project
+
+Xcoder can also create targets, configurations, and add files. Xcoder could be used to programmatically manipulate or install external sources into a project.
+
+It is important to note that Xcode gets cranky when the Xcode project file is changed by external sources. This usually causes the project and schemes to reset or maybe even cause Xcode to crash. It is often best to close the project before manipulating it with Xcoder.
+
+### Add the source and header file to the project
+
+    # Copy the physical source files into the project path `Vendor/Reachability`
+    FileUtils.cp_r "examples/Reachability/Vendor", "spec/TestProject"
+    
+    source_files = [ { 'name' => 'Reachability.m', 'path' => 'Vendor/Reachability/Reachability.m' },
+                     { 'name' => 'Reachability.h', 'path' => 'Vendor/Reachability/Reachability.h' } ]
+
+
+     # Create and traverse to the group Reachability within the Vendor folder
+     project.group('Vendor/Reachability') do
+       # Create files for each source file defined above
+       source_files.each |source| create_file source }
+     end
+     
+
+Within the project file the groups in the path are created or found and then file references are added for the two specified source files. Xcoder only updates the logical project file, it does not copy physical files, that is done by the FileUtils.
+
+
+### Adding source file to the sources build phase
+
+    source_file = project.file('Vendor/Reachability/Reachability.m')
+
+    # Select the main target of the project and add the source file to the build phase.
+
+    project.target('TestProject').sources_build_phase do
+      add_build_file source_file
+    end
+
+Adding source files does not automatically include it in any of the built targets. That is done after you add the source file to the `sources_build_phase`. First we find the source file reference, select our target and then add it as a build file.
+
+### Adding a System Framework
+
+    cfnetwork_framework = project.frameworks_group.create_system_framework 'CFNetwork'
+
+    project.target('TestProject').framework_build_phase do
+      add_build_file cfnetwork_framework
+    end 
+    
+The **CFNetwork.framework** is added to the `Frameworks` group of the project and then added to the frameworks build phase.
+
+### Saving your changes!
+
+
+    project.save!
+
+The saved file output is ugly compared to what you may normally see when you view a Xcode project file. Luckily, Xcode will fix the format of the file if you make any small changes to the project that require it to save.
+
+### More Examples
+
+Within the `specs/integration` folder there are more examples.
+
 ## Tests
 
 There are some basic RSpec tests in the project which I suspect /wont/ work on machines without my identity installed.  

data/lib/xcode/builder.rb

@@ -47,14 +47,18 @@ module Xcode
       cmd << "TEST_HOST=''"
       
       parser = Xcode::Test::OCUnitReportParser.new
-      Xcode::Shell.execute(cmd, false) do |line|
-        puts line
-        parser << line
-      end
-      
       yield(parser) if block_given?
       
-      exit parser.exit_code if parser.exit_code!=0
+      begin
+        Xcode::Shell.execute(cmd, false) do |line|
+          parser << line
+        end
+      rescue => e
+        parser.flush
+        # Let the failure bubble up unless parser has got an error from the output
+        raise e unless parser.failed?
+      end
+      exit 1 if parser.failed?
       
       self
     end
@@ -73,6 +77,7 @@ module Xcode
       cmd = []
       cmd << "xcodebuild"
       cmd << "-project \"#{@target.project.path}\""
+      cmd << "-sdk #{@sdk}" unless @sdk.nil?
       
       cmd << "-scheme #{@scheme.name}" unless @scheme.nil?
       cmd << "-target \"#{@target.name}\"" if @scheme.nil?
@@ -101,6 +106,14 @@ module Xcode
       cmd << "--entitlements \"#{entitlements_path}\""
       cmd << "\"#{ipa_path}\""
       Xcode::Shell.execute(cmd)
+ 
+# CodeSign build/AdHoc-iphoneos/Dial.app
+#     cd "/Users/ray/Projects/Clients/CBAA/Community Radio"
+#     setenv CODESIGN_ALLOCATE /Developer/Platforms/iPhoneOS.platform/Developer/usr/bin/codesign_allocate
+#     setenv PATH "/Developer/Platforms/iPhoneOS.platform/Developer/usr/bin:/Developer/usr/bin:/Users/ray/.rvm/gems/ruby-1.9.2-p290@cbaa/bin:/Users/ray/.rvm/gems/ruby-1.9.2-p290@global/bin:/Users/ray/.rvm/rubies/ruby-1.9.2-p290/bin:/Users/ray/.rvm/bin:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:/usr/X11/bin:/usr/local/git/bin"
+#     /usr/bin/codesign --force --sign "iPhone Distribution: Community Broadcasting Association of Australia" "--resource-rules=/Users/ray/Projects/Clients/CBAA/Community Radio/build/AdHoc-iphoneos/Dial.app/ResourceRules.plist" --keychain "\"/Users/ray/Projects/Clients/CBAA/Community\\" "Radio/Provisioning/CBAA.keychain\"" --entitlements "/Users/ray/Projects/Clients/CBAA/Community Radio/build/CommunityRadio.build/AdHoc-iphoneos/CommunityRadio.build/Dial.xcent" "/Users/ray/Projects/Clients/CBAA/Community Radio/build/AdHoc-iphoneos/Dial.app"
+# iPhone Distribution: Community Broadcasting Association of Australia: no identity found
+# Command /usr/bin/codesign failed with exit code 1
       self
     end
     
@@ -110,7 +123,7 @@ module Xcode
       #package IPA
       cmd = []      
       cmd << "xcrun"
-      cmd << "-sdk #{@target.project.sdk.nil? ? "iphoneos" : @target.project.sdk}"
+      cmd << "-sdk #{@sdk}" unless @sdk.nil?
       cmd << "PackageApplication"
       cmd << "-v \"#{app_path}\""
       cmd << "-o \"#{ipa_path}\""
@@ -183,7 +196,7 @@ module Xcode
       cmd << "-target \"#{@target.name}\"" if @scheme.nil?
       cmd << "-configuration \"#{@config.name}\"" if @scheme.nil?
       
-      cmd << "OTHER_CODE_SIGN_FLAGS=\"--keychain #{@keychain.path}\"" unless @keychain.nil?
+      cmd << "OTHER_CODE_SIGN_FLAGS='--keychain #{@keychain.path}'" unless @keychain.nil?
       cmd << "CODE_SIGN_IDENTITY=\"#{@identity}\"" unless @identity.nil?
       cmd << "OBJROOT=\"#{@build_path}\""
       cmd << "SYMROOT=\"#{@build_path}\""

data/lib/xcode/configuration.rb

@@ -1,4 +1,9 @@
 require 'xcode/builder'
+require 'xcode/configurations/space_delimited_string_property'
+require 'xcode/configurations/targeted_device_family_property'
+require 'xcode/configurations/string_property'
+require 'xcode/configurations/boolean_property'
+require 'xcode/configurations/array_property'
 
 module Xcode
   
@@ -8,7 +13,7 @@ module Xcode
   # defined.
   # 
   # @see https://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/Building/Building.html
-  # 
+  #
   # Each configuration is defined and then a reference of that configuration is
   # maintained in the Target through the XCConfigurationList.
   # 
@@ -29,6 +34,16 @@ module Xcode
   # 
   module Configuration
     
+    #
+    # A large number of these default build settings properties for a configuration 
+    # are as defined for Xcode 4.2.
+    # 
+    # @todo remove the name requirement and replace all these configuration settings
+    #   with the smaller subset. As a lot of these are usually maintained by the project
+    # @param [String] name is used to create the correct prefix header file and 
+    #   info.plist file.
+    # @return [Hash] properties for a default build configuration
+    # 
     def self.default_properties(name)
       { 'isa' => 'XCBuildConfiguration',
         'buildSettings' => {
@@ -54,18 +69,138 @@ module Xcode
     end
     
     #
-    # The configuration is defined within a target.
-    # @see PBXNativeTarget
+    # This method will define getters/setters mapped to the build configuration.
     # 
-    attr_accessor :target
+    # This allows for dynamic values to be saved and loaded by allowing a parsing
+    # process to take place on the loaded value and when saving back to the value.
+    # 
+    # @param [Symbol] property_name the name of the property that is being defined
+    # @param [String setting_name the configuration value string
+    # @param [Types] type is the class that is used to load and save the value
+    #   correctly.
+    # 
+    def self.property(property_name,setting_name,type)
+      
+      # Define a getter method
+
+      define_method property_name do
+        substitute type.open(build_settings[setting_name])
+      end
+
+      # Define a setter method
+      
+      define_method "#{property_name}=" do |value|
+        build_settings[setting_name] = unsubstitute(type.save(value))
+      end
+      
+    end
     
     #
-    # @return the location for the InfoPlist file for the configuration.
-    # @see InfoPlist
+    # As configurations are defined within a target, this will return the target
+    # that owns this configuration through a build_configuration list.
     # 
-    def info_plist_location
-      build_settings['INFOPLIST_FILE']
-    end
+    # However, a build configuration list can also be defined at the project level
+    # which means target may likely be nil when viewing the configuration of
+    # the project.
+    # 
+    # @see Target
+    # @see ConfigurationList
+    # 
+    attr_accessor :target
+
+    # @attribute
+    # Build Setting - "PRODUCT_NAME"
+    property :product_name, "PRODUCT_NAME", StringProperty
+
+    # @attribute
+    # Build Setting - "SUPPORTED_PLATFORMS"
+    property :supported_platforms, "SUPPORTED_PLATFORMS", SpaceDelimitedString
+
+    # @attribute
+    # Build Setting - "GCC_PRECOMPILE_PREFIX_HEADER"
+    # @see https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW11
+    property :precompile_prefix_headers, "GCC_PRECOMPILE_PREFIX_HEADER", BooleanProperty
+
+    # @attribute
+    # Build Setting - "GCC_PREFIX_HEADER"
+    # @see https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW12
+    property :prefix_header, "GCC_PREFIX_HEADER", StringProperty
+    
+    # @attribute
+    # Build Setting - "INFOPLIST_FILE"
+    # @see https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW68
+    property :info_plist_location, "INFOPLIST_FILE", StringProperty
+
+    # @attribute
+    # Build Setting - "WRAPPER_EXTENSION"
+    # @see https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW3
+    property :wrapper_extension, "WRAPPER_EXTENSION", StringProperty
+    
+    # @attribute
+    # Build Setting - "TARGETED_DEVICE_FAMILY"
+    # @see https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW165
+    property :targeted_device_family, "TARGETED_DEVICE_FAMILY", TargetedDeviceFamily
+
+    # @attribute
+    # Build Setting - "SDKROOT"
+    # @see https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW89
+    property :sdkroot, "SDKROOT", StringProperty
+    
+    # @attribute
+    # Build Setting - "OTHER_CFLAGS"
+    # @see https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW17
+    property :other_c_flags, "OTHER_CFLAGS", ArrayProperty
+
+    # @attribute
+    # Build Setting - "GCC_C_LANGUAGE_STANDARD"
+    # Usually set to gnu99
+    property :c_language_standard, "GCC_C_LANGUAGE_STANDARD", StringProperty
+    
+    # @attribute
+    # Build Setting - "ALWAYS_SEARCH_USER_PATHS"
+    # @see https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW110
+    property :always_search_user_paths, "ALWAYS_SEARCH_USER_PATHS", BooleanProperty
+    
+    # @attribute
+    # Build Setting - "GCC_VERSION"
+    # @see https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW15
+    property :gcc_version, "GCC_VERSION", StringProperty
+
+    # @attribute
+    # Build Setting - "ARCHS"
+    # @see https://developer.apple.com/library/mac/#documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW62
+    property :architectures, "ARCHS", SpaceDelimitedString
+
+    # @attribute
+    # Build Setting - "GCC_WARN_ABOUT_MISSING_PROTOTYPES"
+    # Defaults to YES
+    property :warn_about_missing_prototypes, "GCC_WARN_ABOUT_MISSING_PROTOTYPES", BooleanProperty
+
+    # @attribute
+    # Build Setting - "GCC_WARN_ABOUT_MISSING_PROTOTYPES"
+    # @see https://developer.apple.com/library/mac/#documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW123
+    property :warn_about_return_type, "GCC_WARN_ABOUT_RETURN_TYPE", BooleanProperty
+
+    # @attribute
+    # Build Setting - "CODE_SIGN_IDENTITY[sdk=>iphoneos*]"
+    # @see https://developer.apple.com/library/mac/#documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-DontLinkElementID_10
+    property :code_sign_identity, "CODE_SIGN_IDENTITY[sdk=>iphoneos*]", StringProperty
+
+    # @attribute
+    # Build Setting - "VALIDATE_PRODUCT"
+    # @see https://developer.apple.com/library/mac/#documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW167
+    property :validate_product, "VALIDATE_PRODUCT", BooleanProperty
+
+    # @attribute
+    # Build Setting - "IPHONEOS_DEPLOYMENT_TARGET"
+    # @see https://developer.apple.com/library/mac/#documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW156
+    # @todo this should be a numeric scale from 2.0 through 5.0; at the levels specified in the documentation
+    property :iphoneos_deployment_target, "IPHONEOS_DEPLOYMENT_TARGET", StringProperty
+    
+    # @attribute
+    # Build Setting - "COPY_PHASE_STRIP"
+    # @see https://developer.apple.com/library/mac/#documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW144
+    property :copy_phase_strip, "COPY_PHASE_STRIP", BooleanProperty
     
     #
     # Opens the info plist associated with the configuration and allows you to 
@@ -83,19 +218,16 @@ module Xcode
     # @see InfoPlist
     # 
     def info_plist
-      # puts @json.inspect
       info = Xcode::InfoPlist.new(self, info_plist_location)  
       yield info if block_given?
       info.save
       info
     end
     
-    #
-    # @return the name of the product that this configuration will generate.
-    # 
-    def product_name
-      substitute(build_settings['PRODUCT_NAME'])
-    end
+    # @attribute
+    # Build Setting - "USER_HEADER_SEARCH_PATHS"
+    # @see https://developer.apple.com/library/mac/#documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW21
+    property :user_header_search_paths, "USER_HEADER_SEARCH_PATHS", SpaceDelimitedString
     
     #
     # Retrieve the configuration value for the given name
@@ -117,7 +249,6 @@ module Xcode
       build_settings[name] = value
     end
     
-    
     #
     # Create a builder for this given project->target->configuration.
     # 
@@ -125,11 +256,9 @@ module Xcode
     # @see Builder
     # 
     def builder
-      #puts "Making a Builder with #{self} #{self.methods}"
       Xcode::Builder.new(self)
     end
     
-    
     private
     
     #
@@ -141,6 +270,9 @@ module Xcode
     #   the target variable to replace.
     # 
     # @return [String] a string without the variable reference.
+    # 
+    # @todo move this to a decorator that wraps the other objects that load/save
+    #   properties 
     #
     def substitute(value)
       if value=~/\$\(.*\)/
@@ -156,6 +288,21 @@ module Xcode
         value
       end
     end
+    
+    #
+    # @todo currently this performs no operation, but perhaps it should
+    #   in the future to support the ability to persist intelligently back with
+    #   paths
+    # 
+    # @param [Object] value the object that is scanned to figure out if it 
+    #   should have content values replaced with environment variables
+    # 
+    # @todo move this to a decorator that wraps the other objects that load/save
+    #   properties 
+    #
+    def unsubstitute(value)
+      value
+    end
 
   end
 end

data/lib/xcode/configurations/array_property.rb

@@ -0,0 +1,33 @@
+
+module Xcode
+  module Configuration
+    
+    #
+    # Within the a build settings for a configuration there are a number of
+    # settings that are stored as Arrays. This helper module is for the most part 
+    # a pass-through method to provide parity with the other methods.
+    # 
+    module ArrayProperty
+      extend self
+  
+      #
+      # As arrays are stored as arrays this is not particularly different.
+      # 
+      # @param [Array] value to be parsed into the correct format
+      #
+      def open(value)
+        value.to_a
+      end
+    
+      #
+      # @param [Nil,Array,String] value that is being saved back which can
+      #   be in a multitude of formats as long as it responds_to? #to_a
+      #
+      def save(value)
+        value.to_s
+      end
+  
+    end
+    
+  end
+end

data/lib/xcode/configurations/boolean_property.rb

@@ -0,0 +1,42 @@
+
+module Xcode
+  module Configuration
+    
+    #
+    # Within the a build settings for a configuration there are a number of
+    # settings that are stored as Objective-C boolean values. This helper module
+    # provides the opening and saving of these values.
+    # 
+    # When opened the value returns is going to be an Array.
+    # 
+    # @example setting and getting a property
+    # 
+    #     debug_config project.target('SomeTarget').config('Debug')
+    #     debug_config.always_search_user_paths  # => false
+    #     debug_config.always_search_user_paths = true
+    #     debug_config.always_search_user_paths  # true
+    # 
+    module BooleanProperty
+      extend self
+    
+      # 
+      # @param [Nil,TrueClass,FalseClass,String] value to convert to boolean
+      # @return [TrueClass,FalseClass] the boolean value based on the specified
+      #   value.
+      # 
+      def open(value)
+        value.to_s =~ /^YES$/
+      end
+    
+      #
+      # @param [String,FalseClass,TrueClass] value to convert to the Obj-C boolean
+      # @return [String] YES or NO
+      #
+      def save(value)
+        value.to_s =~ /^(?:NO|false)$/ ? "NO" : "YES"
+      end
+  
+    end
+    
+  end
+end

data/lib/xcode/configurations/space_delimited_string_property.rb

@@ -0,0 +1,47 @@
+
+module Xcode  
+  module Configuration
+    
+    #
+    # Within the a build settings for a configuration there are a number of
+    # settings that are stored a space-delimited strings. This helper module
+    # provides the opening and saving of these values.
+    # 
+    # When opened the value returns is going to be an Array.
+    # 
+    # @example common build settings that are space delimited
+    # 
+    #     Supported Platforms      : SUPPORTED_PLATFORMS
+    #     User Header Search Paths : USER_HEADER_SEARCH_PATHS
+    #     Other Test Flags         : OTHER_TEST_FLAGS
+    # 
+    # @example setting and getting supported platforms
+    # 
+    #     debug_config project.target('SomeTarget').config('Debug')
+    #     debug_config.supported_platforms  # => []
+    #     debug_config.supported_platforms = "PLATFORM A"
+    #     debug_config.supported_platforms  # => [ "PLATFORM A" ]
+    # 
+    module SpaceDelimitedString
+      extend self
+  
+      #
+      # @param [Nil,String] value stored within the build settings
+      # @return [Array<String>] a list of the strings that are within this string
+      # 
+      def open(value)
+        value.to_s.split(" ")
+      end
+  
+      #
+      # @param [Array,String] value to be converted into the correct format
+      # @return [String] the space-delimited string
+      #
+      def save(value)
+        Array(value).join(" ")
+      end
+  
+    end
+    
+  end
+end

data/lib/xcode/configurations/string_property.rb

@@ -0,0 +1,25 @@
+
+module Xcode
+  module Configuration
+    
+    #
+    # Within the a build settings for a configuration there are a number of
+    # settings that are stored simply as strings. This helper module
+    # is for the most part a pass-through method to provide parity with the 
+    # other methods.
+    # 
+    module StringProperty
+      extend self
+      
+      def open(value)
+        value.to_s
+      end
+  
+      def save(value)
+        value.to_s
+      end
+  
+    end
+    
+  end
+end

data/lib/xcode/configurations/targeted_device_family_property.rb

@@ -0,0 +1,45 @@
+
+module Xcode
+  module Configuration
+
+    #
+    # Within the a build settings there is a setting for the Targeted Device
+    # Family which assigns particular numeric values to the platform types.
+    # 
+    # Instead of manipulating the numeric values, this will perform a conversion
+    # return an array of symbols with the platforms like :iphone and :ipad.
+    # 
+    module TargetedDeviceFamily
+      extend self
+      
+      #
+      # @param [String] value convert the comma-delimited list of platforms
+      # @return [Array<Symbol>] the platform names supported.
+      #
+      def open(value)
+        value.to_s.split(",").map do |platform_number|
+          platforms[platform_number]
+        end
+      end
+    
+      #
+      # @param [Array<String>] value convert the array of platform names 
+      # @return [String] the comma-delimited list of numeric values representing 
+      #   the platforms.
+      #
+      def save(value)
+        Array(value).map do |platform_name|
+          platforms.map {|number,name| number if name.to_s == platform_name.to_s.downcase }
+        end.flatten.compact.join(",")
+      end
+  
+      private
+  
+      def platforms
+        { "1" => :iphone, "2" => :ipad }
+      end
+  
+    end
+
+  end
+end