Class: Fastlane::Actions::AppetizeAction

Inherits:
Fastlane::Action show all
Defined in:
fastlane/lib/fastlane/actions/appetize.rb

Constant Summary

Constants inherited from Fastlane::Action

Fastlane::Action::AVAILABLE_CATEGORIES, Fastlane::Action::RETURN_TYPES

Class Method Summary collapse

Methods inherited from Fastlane::Action

action_name, author, deprecated_notes, lane_context, method_missing, other_action, return_type, return_value, sample_return_value, shell_out_should_use_bundle_exec?, step_text

Class Method Details

.authorsObject



175
176
177
# File 'fastlane/lib/fastlane/actions/appetize.rb', line 175

def self.authors
  ["klundberg", "giginet", "steprescott"]
end

.available_optionsObject



107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
# File 'fastlane/lib/fastlane/actions/appetize.rb', line 107

def self.available_options
  [
    FastlaneCore::ConfigItem.new(key: :api_host,
                                 env_name: "APPETIZE_API_HOST",
                                 description: "Appetize API host",
                                 is_string: true,
                                 default_value: 'api.appetize.io',
                                 verify_block: proc do |value|
                                   UI.user_error!("API host should not contain the scheme e.g. `https`") if value.start_with?('https')
                                 end),
    FastlaneCore::ConfigItem.new(key: :api_token,
                                 env_name: "APPETIZE_API_TOKEN",
                                 sensitive: true,
                                 description: "Appetize.io API Token",
                                 is_string: true,
                                 verify_block: proc do |value|
                                   UI.user_error!("No API Token for Appetize.io given, pass using `api_token: 'token'`") unless value.to_s.length > 0
                                 end),
    FastlaneCore::ConfigItem.new(key: :url,
                                 env_name: "APPETIZE_URL",
                                 description: "URL from which the ipa file can be fetched. Alternative to :path",
                                 is_string: true,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :platform,
                                 env_name: "APPETIZE_PLATFORM",
                                 description: "Platform. Either `ios` or `android`",
                                 is_string: true,
                                 default_value: 'ios'),
    FastlaneCore::ConfigItem.new(key: :path,
                                 env_name: "APPETIZE_FILE_PATH",
                                 description: "Path to zipped build on the local filesystem. Either this or `url` must be specified",
                                 is_string: true,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :public_key,
                                 env_name: "APPETIZE_PUBLICKEY",
                                 description: "If not provided, a new app will be created. If provided, the existing build will be overwritten",
                                 is_string: true,
                                 optional: true,
                                 verify_block: proc do |value|
                                   if value.start_with?("private_")
                                     UI.user_error!("You provided a private key to appetize, please provide the public key")
                                   end
                                 end),
    FastlaneCore::ConfigItem.new(key: :note,
                                 env_name: "APPETIZE_NOTE",
                                 description: "Notes you wish to add to the uploaded app",
                                 is_string: true,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :timeout,
                                 env_name: "APPETIZE_TIMEOUT",
                                 description: "The number of seconds to wait until automatically ending the session due to user inactivity. Must be 30, 60, 90, 120, 180, 300, 600, 1800, 3600 or 7200. Default is 120",
                                 type: Integer,
                                 optional: true,
                                 verify_block: proc do |value|
                                   UI.user_error!("The value provided doesn't match any of the supported options.") unless [30, 60, 90, 120, 180, 300, 600, 1800, 3600, 7200].include?(value)
                                 end)
  ]
end

.categoryObject



179
180
181
# File 'fastlane/lib/fastlane/actions/appetize.rb', line 179

def self.category
  :beta
end

.descriptionObject



95
96
97
# File 'fastlane/lib/fastlane/actions/appetize.rb', line 95

def self.description
  "Upload your app to [Appetize.io](https://appetize.io/) to stream it in browser"
end

.detailsObject



99
100
101
102
103
104
105
# File 'fastlane/lib/fastlane/actions/appetize.rb', line 99

def self.details
  [
    "If you provide a `public_key`, this will overwrite an existing application. If you want to have this build as a new app version, you shouldn't provide this value.",
    "",
    "To integrate appetize into your GitHub workflow check out the [device_grid guide](https://github.com/fastlane/fastlane/blob/master/fastlane/lib/fastlane/actions/device_grid/README.md)."
  ].join("\n")
end

.example_codeObject



183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
# File 'fastlane/lib/fastlane/actions/appetize.rb', line 183

def self.example_code
  [
    'appetize(
      path: "./MyApp.zip",
      api_token: "yourapitoken", # get it from https://appetize.io/docs#request-api-token
      public_key: "your_public_key" # get it from https://appetize.io/dashboard
    )',
    'appetize(
      path: "./MyApp.zip",
      api_host: "company.appetize.io", # only needed for enterprise hosted solution
      api_token: "yourapitoken", # get it from https://appetize.io/docs#request-api-token
      public_key: "your_public_key" # get it from https://appetize.io/dashboard
    )'
  ]
end

.is_supported?(platform) ⇒ Boolean

Returns:



11
12
13
# File 'fastlane/lib/fastlane/actions/appetize.rb', line 11

def self.is_supported?(platform)
  [:ios, :android].include?(platform)
end

.outputObject



166
167
168
169
170
171
172
173
# File 'fastlane/lib/fastlane/actions/appetize.rb', line 166

def self.output
  [
    ['APPETIZE_API_HOST', 'Appetize API host.'],
    ['APPETIZE_PUBLIC_KEY', 'a public identifier for your app. Use this to update your app after it has been initially created.'],
    ['APPETIZE_APP_URL', 'a page to test and share your app.'],
    ['APPETIZE_MANAGE_URL', 'a page to manage your app.']
  ]
end

.run(options) ⇒ Object



15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
# File 'fastlane/lib/fastlane/actions/appetize.rb', line 15

def self.run(options)
  require 'net/http'
  require 'net/http/post/multipart'
  require 'uri'
  require 'json'

  params = {
    platform: options[:platform]
  }

  if options[:path]
    params[:file] = UploadIO.new(options[:path], 'application/zip')
  else
    UI.user_error!('url parameter is required if no file path is specified') if options[:url].nil?
    params[:url] = options[:url]
  end

  params[:note] = options[:note] if options[:note].to_s.length > 0

  if options[:timeout]
    params[:timeout] = options[:timeout]
  end

  uri = URI.parse(appetize_url(options))
  req = create_request(uri, params)
  req.basic_auth(options[:api_token], nil)

  http = Net::HTTP.new(uri.host, uri.port)
  http.use_ssl = true

  if params[:platform] == 'ios'
    UI.message("Uploading ipa to appetize... this might take a while")
  else
    UI.message("Uploading apk to appetize... this might take a while")
  end

  response = http.request(req)

  parse_response(response) # this will raise an exception if something goes wrong

  UI.message("App URL: #{Actions.lane_context[SharedValues::APPETIZE_APP_URL]}")
  UI.message("Manage URL: #{Actions.lane_context[SharedValues::APPETIZE_MANAGE_URL]}")
  UI.message("Public Key: #{Actions.lane_context[SharedValues::APPETIZE_PUBLIC_KEY]}")
  UI.success("Build successfully uploaded to Appetize.io")
end