emerge 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4ada02f9680b03cfcf2d4350d0aa719ae8c1a0399e7783b468b341e2eac5143
-  data.tar.gz: 7dfc873c8ba7cb9dd145b7ae181cdcadbe494741ac6f241fcdd0cb48f3c88526
+  metadata.gz: 0cce2cb7764c86a70569537aab8d02bd3136df5c4b25b2421164bf0e28256623
+  data.tar.gz: e4cce6ab186fd05a9910acc99cb279d60e7799f36273f45d6496523e785ede62
 SHA512:
-  metadata.gz: 4ae1796a1d262846e12bf5b1f64301166209b0ad31f4981effb118a4c091d0f36c5396e169c881b8baea1f5fc93e18f8aa452eb1e05775eeab79b615e6b38370
-  data.tar.gz: ff14aac430f27b95be0d6267839d967e9869b31090c669d68c0e8fefb34dd6e3468bc627080f36ce27aaa1288d73e2698c5800614035f5218d7d71a2a5182aef
+  metadata.gz: 5ebaf9ef828373305f07c597fb2968d2e046689d5954226210ba9ca164c919b146bc208c83adcd77acc77d7a535feeeb31c7cc0718944c05fb7990cbc7e1beee
+  data.tar.gz: 46e65589c521670cff6ff14106e96c33d9fb2aa0d8293b5521878f1e97a2aef59516a193a08c75b4371c1d83af15b2b98f56e8245bdd4c83c72c0565c3c6130a

data/lib/commands/autofixes/exported_symbols.rb

@@ -0,0 +1,62 @@
+require 'dry/cli'
+require 'xcodeproj'
+
+module EmergeCLI
+  module Commands
+    module Autofixes
+      class ExportedSymbols < EmergeCLI::Commands::GlobalOptions
+        desc 'Remove exported symbols from built binaries'
+
+        option :path, type: :string, required: true, desc: 'Path to the xcarchive'
+
+        # Constants
+        DEFAULT_EXPORTED_SYMBOLS = %(_main
+__mh_execute_header).freeze
+        EXPORTED_SYMBOLS_FILE = 'EXPORTED_SYMBOLS_FILE'.freeze
+        EXPORTED_SYMBOLS_PATH = '$(SRCROOT)/EmergeToolsHelperFiles/ExportedSymbols'.freeze
+        EXPORTED_SYMBOLS_FILE_NAME = 'ExportedSymbols'.freeze
+        EMERGE_TOOLS_GROUP = 'EmergeToolsHelperFiles'.freeze
+
+        def call(**options)
+          @options = options
+          before(options)
+
+          raise 'Path must be an xcodeproj' unless @options[:path].end_with?('.xcodeproj')
+          raise 'Path does not exist' unless File.exist?(@options[:path])
+
+          Sync do
+            project = Xcodeproj::Project.open(@options[:path])
+
+            # Add the exported symbols file to the project
+            group = project.main_group
+            emergetools_group = group.find_subpath(EMERGE_TOOLS_GROUP, true)
+            emergetools_group.set_path(EMERGE_TOOLS_GROUP)
+
+            unless emergetools_group.find_file_by_path(EXPORTED_SYMBOLS_FILE_NAME)
+              emergetools_group.new_file(EXPORTED_SYMBOLS_FILE_NAME)
+            end
+
+            # Create Folder if it doesn't exist
+
+            FileUtils.mkdir_p(File.join(File.dirname(@options[:path]), EMERGE_TOOLS_GROUP))
+
+            # Create the exported symbols file
+            path = File.join(File.dirname(@options[:path]), EMERGE_TOOLS_GROUP, EXPORTED_SYMBOLS_FILE_NAME)
+            File.write(path, DEFAULT_EXPORTED_SYMBOLS)
+
+            project.targets.each do |target|
+              # Only do it for app targets
+              next unless target.product_type == 'com.apple.product-type.application'
+
+              target.build_configurations.each do |config|
+                config.build_settings[EXPORTED_SYMBOLS_FILE] = EXPORTED_SYMBOLS_PATH
+              end
+            end
+
+            project.save
+          end
+        end
+      end
+    end
+  end
+end

data/lib/commands/autofixes/minify_strings.rb

@@ -0,0 +1,99 @@
+require 'dry/cli'
+require 'xcodeproj'
+
+module EmergeCLI
+  module Commands
+    module Autofixes
+      class MinifyStrings < EmergeCLI::Commands::GlobalOptions
+        desc 'Minify strings in the app'
+
+        option :path, type: :string, required: true, desc: 'Path to the xcarchive'
+
+        # Constants
+        SCRIPT_NAME = 'EmergeTools Minify Strings'.freeze
+        ENABLE_USER_SCRIPT_SANDBOXING = 'ENABLE_USER_SCRIPT_SANDBOXING'.freeze
+        STRINGS_FILE_OUTPUT_ENCODING = 'STRINGS_FILE_OUTPUT_ENCODING'.freeze
+        STRINGS_FILE_OUTPUT_ENCODING_VALUE = 'UTF-8'.freeze
+        SCRIPT_CONTENT = %{import os
+import json
+from multiprocessing.pool import ThreadPool
+
+def minify(file_path):
+  os.system(f"plutil -convert json '{file_path}'")
+  new_content = ''
+  try:
+    with open(file_path, 'r') as input_file:
+      data = json.load(input_file)
+
+      for key, value in data.items():
+        fixed_key = json.dumps(key, ensure_ascii=False).encode('utf8').decode()
+        fixed_value = json.dumps(value, ensure_ascii=False).encode('utf8').decode()
+        new_line = f'{fixed_key} = {fixed_value};\\n'
+        new_content += new_line
+
+    with open(file_path, 'w') as output_file:
+      output_file.write(new_content)
+  except:
+    return
+
+file_extension = '.strings'
+stringFiles = []
+
+for root, _, files in os.walk(os.environ['BUILT_PRODUCTS_DIR'], followlinks=True):
+  for filename in files:
+    if filename.endswith(file_extension):
+      input_path = os.path.join(root, filename)
+      stringFiles.append(input_path)
+
+# create a thread pool
+with ThreadPool() as pool:
+  pool.map(minify, stringFiles)
+}.freeze
+
+        def call(**options)
+          @options = options
+          before(options)
+
+          raise 'Path must be an xcodeproj' unless @options[:path].end_with?('.xcodeproj')
+          raise 'Path does not exist' unless File.exist?(@options[:path])
+
+          Sync do
+            project = Xcodeproj::Project.open(@options[:path])
+
+            project.targets.each do |target|
+              target.build_configurations.each do |config|
+                enable_user_script_sandboxing(config)
+                set_output_encoding(config)
+              end
+
+              add_run_script(target)
+            end
+
+            project.save
+          end
+        end
+
+        private
+
+        def enable_user_script_sandboxing(config)
+          Logger.info "Enabling user script sandboxing for #{config.name}"
+          config.build_settings[ENABLE_USER_SCRIPT_SANDBOXING] = 'NO'
+        end
+
+        def set_output_encoding(config)
+          Logger.info "Setting output encoding for #{config.name}"
+          config.build_settings[STRINGS_FILE_OUTPUT_ENCODING] = STRINGS_FILE_OUTPUT_ENCODING_VALUE
+        end
+
+        def add_run_script(target)
+          phase = target.shell_script_build_phases.find { |item| item.name == SCRIPT_NAME }
+          return unless phase.nil?
+          Logger.info "Creating script '#{SCRIPT_NAME}'"
+          phase = target.new_shell_script_build_phase(SCRIPT_NAME)
+          phase.shell_script = SCRIPT_CONTENT
+          phase.shell_path = `which python3`.strip
+        end
+      end
+    end
+  end
+end

data/lib/commands/autofixes/strip_binary_symbols.rb

@@ -0,0 +1,116 @@
+require 'dry/cli'
+require 'xcodeproj'
+
+module EmergeCLI
+  module Commands
+    module Autofixes
+      class StripBinarySymbols < EmergeCLI::Commands::GlobalOptions
+        desc 'Strip binary symbols from the app'
+
+        option :path, type: :string, required: true, desc: 'Path to the xcarchive'
+
+        # Constants
+        SCRIPT_NAME = 'EmergeTools Strip Binary Symbols'.freeze
+        ENABLE_USER_SCRIPT_SANDBOXING = 'ENABLE_USER_SCRIPT_SANDBOXING'.freeze
+        INPUT_FILE = '${DWARF_DSYM_FOLDER_PATH}/${EXECUTABLE_NAME}.app.dSYM/' \
+                     'Contents/Resources/DWARF/${EXECUTABLE_NAME}'.freeze
+        SCRIPT_CONTENT = %{#!/bin/bash
+set -e
+
+echo "Starting the symbol stripping process..."
+
+if [ "Release" = "$\{CONFIGURATION\}" ]; then
+  echo "Configuration is Release."
+
+  # Path to the app directory
+  APP_DIR_PATH="$\{BUILT_PRODUCTS_DIR\}/$\{EXECUTABLE_FOLDER_PATH\}"
+  echo "App directory path: $\{APP_DIR_PATH\}"
+
+  # Strip main binary
+  echo "Stripping main binary: $\{APP_DIR_PATH\}/$\{EXECUTABLE_NAME\}"
+  strip -rSTx "$\{APP_DIR_PATH\}/$\{EXECUTABLE_NAME\}"
+  if [ $? -eq 0 ]; then
+    echo "Successfully stripped main binary."
+  else
+    echo "Failed to strip main binary." >&2
+  fi
+
+  # Path to the Frameworks directory
+  APP_FRAMEWORKS_DIR="$\{APP_DIR_PATH\}/Frameworks"
+  echo "Frameworks directory path: $\{APP_FRAMEWORKS_DIR\}"
+
+  # Strip symbols from frameworks, if Frameworks/ exists at all
+  # ... as long as the framework is NOT signed by Apple
+  if [ -d "$\{APP_FRAMEWORKS_DIR\}" ]; then
+    echo "Frameworks directory exists. Proceeding to strip symbols from frameworks."
+    find "$\{APP_FRAMEWORKS_DIR\}" -type f -perm +111 -maxdepth 2 -mindepth 2 -exec bash -c '
+    codesign -v -R="anchor apple" "\{\}" &> /dev/null ||
+    (
+        echo "Stripping \{\}" &&
+        if [ -w "\{\}" ]; then
+            strip -rSTx "\{\}"
+            if [ $? -eq 0 ]; then
+                echo "Successfully stripped \{\}"
+            else
+                echo "Failed to strip \{\}" >&2
+            fi
+        else
+            echo "Warning: No write permission for \{\}"
+        fi
+    )
+    ' \\;
+    if [ $? -eq 0 ]; then
+        echo "Successfully stripped symbols from frameworks."
+    else
+        echo "Failed to strip symbols from some frameworks." >&2
+    fi
+  else
+    echo "Frameworks directory does not exist. Skipping framework stripping."
+  fi
+else
+  echo "Configuration is not Release. Skipping symbol stripping."
+fi
+
+echo "Symbol stripping process completed."}.freeze
+
+        def call(**options)
+          @options = options
+          before(options)
+
+          raise 'Path must be an xcodeproj' unless @options[:path].end_with?('.xcodeproj')
+          raise 'Path does not exist' unless File.exist?(@options[:path])
+
+          Sync do
+            project = Xcodeproj::Project.open(@options[:path])
+
+            project.targets.each do |target|
+              target.build_configurations.each do |config|
+                enable_user_script_sandboxing(config)
+              end
+
+              add_run_script(target)
+            end
+
+            project.save
+          end
+        end
+
+        private
+
+        def enable_user_script_sandboxing(config)
+          Logger.info "Enabling user script sandboxing for #{config.name}"
+          config.build_settings[ENABLE_USER_SCRIPT_SANDBOXING] = 'NO'
+        end
+
+        def add_run_script(target)
+          phase = target.shell_script_build_phases.find { |item| item.name == SCRIPT_NAME }
+          return unless phase.nil?
+          Logger.info "Creating script '#{SCRIPT_NAME}'"
+          phase = target.new_shell_script_build_phase(SCRIPT_NAME)
+          phase.shell_script = SCRIPT_CONTENT
+          phase.input_paths = [INPUT_FILE]
+        end
+      end
+    end
+  end
+end

data/lib/commands/build_distribution/download_and_install.rb

@@ -0,0 +1,139 @@
+require 'dry/cli'
+require 'cfpropertylist'
+require 'zip'
+require 'rbconfig'
+require 'tmpdir'
+
+module EmergeCLI
+  module Commands
+    module BuildDistribution
+      class DownloadAndInstall < EmergeCLI::Commands::GlobalOptions
+        desc 'Download build from Build Distribution'
+
+        option :api_token, type: :string, required: false,
+                           desc: 'API token for authentication, defaults to ENV[EMERGE_API_TOKEN]'
+        option :build_id, type: :string, required: true, desc: 'Build ID to download'
+        option :install, type: :boolean, default: true, required: false, desc: 'Install the build on the device'
+        option :device_id, type: :string, desc: 'Specific device ID to target'
+        option :device_type, type: :string, enum: %w[virtual physical any], default: 'any',
+                             desc: 'Type of device to target (virtual/physical/any)'
+        option :output, type: :string, required: false, desc: 'Output path for the downloaded build'
+
+        def initialize(network: nil)
+          @network = network
+        end
+
+        def call(**options)
+          @options = options
+          before(options)
+
+          Sync do
+            api_token = @options[:api_token] || ENV.fetch('EMERGE_API_TOKEN', nil)
+            raise 'API token is required' unless api_token
+
+            raise 'Build ID is required' unless @options[:build_id]
+
+            output_name = nil
+            app_id = nil
+
+            begin
+              @network ||= EmergeCLI::Network.new(api_token:)
+
+              Logger.info 'Getting build URL...'
+              request = get_build_url(@options[:build_id])
+              response = parse_response(request)
+
+              platform = response['platform']
+              download_url = response['downloadUrl']
+              app_id = response['appId']
+
+              extension = platform == 'ios' ? 'ipa' : 'apk'
+              Logger.info 'Downloading build...'
+              output_name = @options[:output] || "#{@options[:build_id]}.#{extension}"
+              `curl --progress-bar -L '#{download_url}' -o #{output_name} `
+              Logger.info "✅ Build downloaded to #{output_name}"
+            rescue StandardError => e
+              Logger.error "❌ Failed to download build: #{e.message}"
+              raise e
+            ensure
+              @network&.close
+            end
+
+            begin
+              if @options[:install] && !output_name.nil?
+                if platform == 'ios'
+                  install_ios_build(output_name, app_id)
+                elsif platform == 'android'
+                  install_android_build(output_name)
+                end
+              end
+            rescue StandardError => e
+              Logger.error "❌ Failed to install build: #{e.message}"
+              raise e
+            end
+          end
+        end
+
+        private
+
+        def get_build_url(build_id)
+          @network.get(
+            path: '/distribution/downloadUrl',
+            max_retries: 3,
+            query: {
+              buildId: build_id
+            }
+          )
+        end
+
+        def parse_response(response)
+          case response.status
+          when 200
+            JSON.parse(response.read)
+          when 400
+            error_message = JSON.parse(response.read)['errorMessage']
+            raise "Invalid parameters: #{error_message}"
+          when 401, 403
+            raise 'Invalid API token'
+          else
+            raise "Getting build failed with status #{response.status}"
+          end
+        end
+
+        def install_ios_build(build_path, app_id)
+          device_type = case @options[:device_type]
+                        when 'simulator'
+                          XcodeDeviceManager::DeviceType::VIRTUAL
+                        when 'physical'
+                          XcodeDeviceManager::DeviceType::PHYSICAL
+                        else
+                          XcodeDeviceManager::DeviceType::ANY
+                        end
+
+          device_manager = XcodeDeviceManager.new
+          device = if @options[:device_id]
+                     device_manager.find_device_by_id(@options[:device_id])
+                   else
+                     device_manager.find_device_by_type(device_type, build_path)
+                   end
+
+          Logger.info "Installing build on #{device.device_id}"
+          device.install_app(build_path)
+          Logger.info '✅ Build installed'
+
+          Logger.info "Launching app #{app_id}..."
+          device.launch_app(app_id)
+          Logger.info '✅ Build launched'
+        end
+
+        def install_android_build(build_path)
+          command = "adb -s #{@options[:device_id]} install #{build_path}"
+          Logger.debug "Running command: #{command}"
+          `#{command}`
+
+          Logger.info '✅ Build installed'
+        end
+      end
+    end
+  end
+end

data/lib/commands/build_distribution/validate_app.rb

@@ -0,0 +1,164 @@
+require 'dry/cli'
+require 'cfpropertylist'
+require 'zip'
+require 'rbconfig'
+
+module EmergeCLI
+  module Commands
+    module BuildDistribution
+      class ValidateApp < EmergeCLI::Commands::GlobalOptions
+        desc 'Validate app for build distribution'
+
+        option :path, type: :string, required: true, desc: 'Path to the xcarchive, IPA or APK to validate'
+
+        # Constants
+        PLIST_START = '<plist'.freeze
+        PLIST_STOP = '</plist>'.freeze
+
+        UTF8_ENCODING = 'UTF-8'.freeze
+        STRING_FORMAT = 'binary'.freeze
+        EMPTY_STRING = ''.freeze
+
+        EXPECTED_ABI = 'arm64-v8a'.freeze
+
+        def call(**options)
+          @options = options
+          before(options)
+
+          Sync do
+            file_extension = File.extname(@options[:path])
+            case file_extension
+            when '.xcarchive'
+              handle_xcarchive
+            when '.ipa'
+              handle_ipa
+            when '.app'
+              handle_app
+            when '.apk'
+              handle_apk
+            else
+              raise "Unknown file extension: #{file_extension}"
+            end
+          end
+        end
+
+        private
+
+        def handle_xcarchive
+          raise 'Path must be an xcarchive' unless @options[:path].end_with?('.xcarchive')
+
+          app_path = Dir.glob("#{@options[:path]}/Products/Applications/*.app").first
+          run_codesign_check(app_path)
+          read_provisioning_profile(app_path)
+        end
+
+        def handle_ipa
+          raise 'Path must be an IPA' unless @options[:path].end_with?('.ipa')
+
+          Dir.mktmpdir do |tmp_dir|
+            Zip::File.open(@options[:path]) do |zip_file|
+              zip_file.each do |entry|
+                entry.extract(File.join(tmp_dir, entry.name))
+              end
+            end
+
+            app_path = File.join(tmp_dir, 'Payload/*.app')
+            app_path = Dir.glob(app_path).first
+            run_codesign_check(app_path)
+            read_provisioning_profile(app_path)
+          end
+        end
+
+        def handle_app
+          raise 'Path must be an app' unless @options[:path].end_with?('.app')
+
+          app_path = @options[:path]
+          run_codesign_check(app_path)
+          read_provisioning_profile(app_path)
+        end
+
+        def handle_apk
+          raise 'Path must be an APK' unless @options[:path].end_with?('.apk')
+
+          apk_path = @options[:path]
+          check_supported_abis(apk_path)
+        end
+
+        def run_codesign_check(app_path)
+          unless RbConfig::CONFIG['host_os'] =~ /darwin/i
+            Logger.info 'Skipping codesign check on non-macOS platform'
+            return
+          end
+
+          command = "codesign -dvvv '#{app_path}'"
+          Logger.debug command
+          stdout, _, status = Open3.capture3(command)
+          Logger.debug stdout
+          raise '❌ Codesign check failed' unless status.success?
+
+          Logger.info '✅ Codesign check passed'
+        end
+
+        def read_provisioning_profile(app_path)
+          entitlements_path = File.join(app_path, 'embedded.mobileprovision')
+          raise '❌ Entitlements file not found' unless File.exist?(entitlements_path)
+
+          content = File.read(entitlements_path)
+          lines = content.lines
+
+          buffer = ''
+          inside_plist = false
+          lines.each do |line|
+            inside_plist = true if line.include? PLIST_START
+            if inside_plist
+              buffer << line
+              break if line.include? PLIST_STOP
+            end
+          end
+
+          encoded_plist = buffer.encode(UTF8_ENCODING, STRING_FORMAT, invalid: :replace, undef: :replace,
+                                                                      replace: EMPTY_STRING)
+          encoded_plist = encoded_plist.sub(/#{PLIST_STOP}.+/, PLIST_STOP)
+
+          plist = CFPropertyList::List.new(data: encoded_plist)
+          parsed_data = CFPropertyList.native_types(plist.value)
+
+          expiration_date = parsed_data['ExpirationDate']
+          if expiration_date > Time.now
+            Logger.info '✅ Provisioning profile hasn\'t expired'
+          else
+            Logger.info "❌ Provisioning profile is expired. Expiration date: #{expiration_date}"
+          end
+
+          provisions_all_devices = parsed_data['ProvisionsAllDevices']
+          if provisions_all_devices
+            Logger.info 'Provisioning profile supports all devices (likely an enterprise profile)'
+          else
+            devices = parsed_data['ProvisionedDevices']
+            Logger.info 'Provisioning profile does not support all devices (likely a development profile).'
+            Logger.info "Devices: #{devices.inspect}"
+          end
+        end
+
+        def check_supported_abis(apk_path)
+          abis = []
+
+          Zip::File.open(apk_path) do |zip_file|
+            zip_file.each do |entry|
+              if entry.name.start_with?('lib/') && entry.name.count('/') == 2
+                abi = entry.name.split('/')[1]
+                abis << abi unless abis.include?(abi)
+              end
+            end
+          end
+
+          unless abis.include?(EXPECTED_ABI)
+            raise "APK does not support #{EXPECTED_ABI} architecture, found: #{abis.join(', ')}"
+          end
+
+          Logger.info "✅ APK supports #{EXPECTED_ABI} architecture"
+        end
+      end
+    end
+  end
+end

data/lib/commands/order_files/validate_xcode_project.rb

@@ -0,0 +1,71 @@
+require 'dry/cli'
+require 'xcodeproj'
+
+module EmergeCLI
+  module Commands
+    class ValidateXcodeProject < EmergeCLI::Commands::GlobalOptions
+      desc 'Validate xcodeproject for order files'
+
+      option :path, type: :string, required: true, desc: 'Path to the xcodeproject to validate'
+      option :target, type: :string, required: false, desc: 'Target to validate'
+      option :build_configuration, type: :string, required: false,
+                                   desc: 'Build configuration to validate (Release by default)'
+
+      # Constants
+      LINK_MAPS_CONFIG = 'LD_GENERATE_MAP_FILE'.freeze
+      LINK_MAPS_PATH = 'LD_MAP_FILE_PATH'.freeze
+      PATH_TO_LINKMAP = '$(TARGET_TEMP_DIR)/$(PRODUCT_NAME)-LinkMap-$(CURRENT_VARIANT)-$(CURRENT_ARCH).txt'.freeze
+
+      def call(**options)
+        @options = options
+        before(options)
+
+        raise 'Path must be an xcodeproject' unless @options[:path].end_with?('.xcodeproj')
+        raise 'Path does not exist' unless File.exist?(@options[:path])
+
+        @options[:build_configuration] ||= 'Release'
+
+        Sync do
+          project = Xcodeproj::Project.open(@options[:path])
+
+          validate_xcproj(project)
+        end
+      end
+
+      private
+
+      def validate_xcproj(project)
+        project.targets.each do |target|
+          next if @options[:target] && target.name != @options[:target]
+          next unless target.product_type == 'com.apple.product-type.application'
+
+          target.build_configurations.each do |config|
+            next if config.name != @options[:build_configuration]
+            validate_target_config(target, config)
+          end
+        end
+      end
+
+      def validate_target_config(target, config)
+        has_error = false
+        if config.build_settings[LINK_MAPS_CONFIG] != 'YES'
+          has_error = true
+          Logger.error "❌ Write Link Map File (#{LINK_MAPS_CONFIG}) is not set to YES"
+        end
+        if config.build_settings[LINK_MAPS_PATH] != ''
+          has_error = true
+          Logger.error "❌ Path to Link Map File (#{LINK_MAPS_PATH}) is not set, we recommend \
+setting it to '#{PATH_TO_LINKMAP}'"
+        end
+
+        if has_error
+          Logger.error "❌ Target '#{target.name}' has errors, this means \
+that the linkmaps will not be generated as expected"
+          Logger.error "Use `emerge configure order-files-ios --project-path '#{@options[:path]}'` to fix this"
+        else
+          Logger.info "✅ Target '#{target.name}' is valid"
+        end
+      end
+    end
+  end
+end