fastlane-plugin-shield_ios 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c27fcda8a05cb9bf1ea7dae37d2ebad5e83f569a7cd45df44fa2ec0bbe237147
+  data.tar.gz: 91ac33e8943c85f83857def2a0ef0ffe42df56c517ec33240127f8e451d58609
+SHA512:
+  metadata.gz: ec4e3631ac117a774671e3ab38544be738922915fc46b0512f074eef5f31579712ff5bb3aa88299e20015bf5df6ee1af1518ac5f85879582db806420d470a7ab
+  data.tar.gz: 70bb95940d9a7813e6e502148bcb760a12032e041e642abbbeef8b476265b4492b48596da6ffc976c6295385cbb10139823e53ee2467f4a5b0743c35161d9da0

data/LICENSE

@@ -0,0 +1,56 @@
+ByteHide Shield iOS - Commercial License
+
+Copyright (c) 2024-2026 ByteHide Solutions S.L. All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary property of ByteHide Solutions S.L. and are protected by copyright
+law and international treaties.
+
+GRANT OF LICENSE
+
+Subject to the terms of a valid commercial license agreement between you (or
+your organization) and ByteHide Solutions S.L., you are granted a limited,
+non-exclusive, non-transferable license to use the Software solely in accordance
+with the terms of your subscription plan.
+
+RESTRICTIONS
+
+You may not, without the prior written consent of ByteHide Solutions S.L.:
+
+  1. Copy, modify, or distribute the Software or any portion thereof.
+  2. Reverse engineer, decompile, or disassemble the Software.
+  3. Sublicense, rent, lease, or lend the Software to any third party.
+  4. Remove or alter any proprietary notices, labels, or marks on the Software.
+  5. Use the Software to develop a competing product or service.
+
+SUBSCRIPTION AND ACTIVATION
+
+Use of this Software requires a valid ByteHide project token linked to an
+active subscription. The Software communicates with ByteHide services for
+license validation and feature entitlement. Unauthorized use, circumvention
+of license checks, or use without a valid subscription is strictly prohibited.
+
+DISCLAIMER OF WARRANTIES
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+LIMITATION OF LIABILITY
+
+IN NO EVENT SHALL BYTEHIDE SOLUTIONS S.L. BE LIABLE FOR ANY CLAIM, DAMAGES
+OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+
+GOVERNING LAW
+
+This license shall be governed by and construed in accordance with the laws
+of Spain. Any disputes arising under this license shall be subject to the
+exclusive jurisdiction of the courts of Valencia, Spain.
+
+CONTACT
+
+ByteHide Solutions S.L.
+https://www.bytehide.com
+contact@bytehide.com

data/README.md

@@ -0,0 +1,120 @@
+# fastlane-plugin-shield_ios
+
+[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-shield_ios)
+
+Fastlane plugin for [ByteHide Shield iOS](https://www.bytehide.com) — protect your iOS applications with obfuscation, encryption, and runtime security directly from your CI/CD pipeline.
+
+## Getting Started
+
+### Prerequisites
+
+Install the `shield-ios` CLI:
+
+```bash
+pip install bytehide-shield-ios
+```
+
+### Add the Plugin
+
+```bash
+fastlane add_plugin shield_ios
+```
+
+Or add it to your `Pluginfile`:
+
+```ruby
+gem "fastlane-plugin-shield_ios", path: "../fastlane-plugin-shield_ios"
+```
+
+## Usage
+
+```ruby
+# Fastfile
+default_platform(:ios)
+
+platform :ios do
+  lane :release do
+    build_app(
+      scheme: "MyApp",
+      archive_path: "build/MyApp.xcarchive",
+      skip_package_ipa: true
+    )
+
+    shield_ios(
+      archive_path: "build/MyApp.xcarchive",
+      config: "shield-ios.json"
+    )
+
+    build_app(
+      archive_path: "build/MyApp.xcarchive",
+      skip_build_archive: true
+    )
+
+    upload_to_app_store
+  end
+end
+```
+
+## Parameters
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `archive_path` | String | Yes | — | Path to the `.xcarchive` or `.ipa` to protect |
+| `output_path` | String | No | Same as input | Output path for the protected archive |
+| `config` | String | No | `nil` | Path to `shield-ios.json` configuration file |
+| `no_sign` | Boolean | No | `true` | Skip code signing after protection |
+| `verbose` | Boolean | No | `false` | Enable verbose output |
+
+All parameters can also be set via environment variables:
+
+- `SHIELD_IOS_ARCHIVE_PATH`
+- `SHIELD_IOS_OUTPUT_PATH`
+- `SHIELD_IOS_CONFIG`
+- `SHIELD_IOS_NO_SIGN`
+- `SHIELD_IOS_VERBOSE`
+
+## Examples
+
+### Basic protection
+
+```ruby
+shield_ios(archive_path: "build/MyApp.xcarchive")
+```
+
+### With configuration file
+
+```ruby
+shield_ios(
+  archive_path: "build/MyApp.xcarchive",
+  config: "shield-ios.json"
+)
+```
+
+### Custom output path with re-signing
+
+```ruby
+shield_ios(
+  archive_path: "build/MyApp.xcarchive",
+  output_path: "build/MyApp-protected.xcarchive",
+  no_sign: false,
+  verbose: true
+)
+```
+
+### Protect an IPA
+
+```ruby
+shield_ios(
+  archive_path: "build/MyApp.ipa",
+  config: "shield-ios.json"
+)
+```
+
+## Documentation
+
+- [ByteHide Shield iOS Documentation](https://docs.bytehide.com/platforms/ios/products/shield)
+- [ByteHide Website](https://www.bytehide.com)
+
+## License
+
+Copyright (c) 2024-2026 ByteHide Solutions S.L. All rights reserved. See [LICENSE](LICENSE) for details.

data/lib/fastlane/plugin/shield_ios/actions/shield_ios_action.rb

@@ -0,0 +1,117 @@
+require 'fastlane/action'
+require_relative '../helper/shield_ios_helper'
+
+module Fastlane
+  module Actions
+    class ShieldIosAction < Action
+      def self.run(params)
+        unless Helper::ShieldIosHelper.shield_ios_installed?
+          UI.user_error!("shield-ios CLI not found. Install it with: pip install bytehide-shield-ios")
+        end
+
+        archive_path = params[:archive_path]
+        unless File.exist?(archive_path)
+          UI.user_error!("Archive not found at path: #{archive_path}")
+        end
+
+        command = Helper::ShieldIosHelper.build_command(params)
+
+        UI.message("Protecting iOS app with ByteHide Shield...")
+        UI.message("Running: #{command}") if params[:verbose]
+
+        Actions.sh(command)
+
+        UI.success("ByteHide Shield iOS protection applied successfully!")
+      end
+
+      def self.description
+        "Protect your iOS app with ByteHide Shield obfuscation and security"
+      end
+
+      def self.authors
+        ["ByteHide"]
+      end
+
+      def self.details
+        "Applies ByteHide Shield iOS protections (obfuscation, encryption, and runtime security) " \
+          "to an .xcarchive or .ipa file. Requires the shield-ios CLI to be installed."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(
+            key: :archive_path,
+            env_name: "SHIELD_IOS_ARCHIVE_PATH",
+            description: "Path to the .xcarchive or .ipa to protect",
+            type: String,
+            verify_block: proc do |value|
+              unless value.end_with?(".xcarchive", ".ipa")
+                UI.user_error!("archive_path must be an .xcarchive or .ipa file")
+              end
+            end
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :output_path,
+            env_name: "SHIELD_IOS_OUTPUT_PATH",
+            description: "Output path for the protected archive (defaults to overwriting the input)",
+            type: String,
+            optional: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :config,
+            env_name: "SHIELD_IOS_CONFIG",
+            description: "Path to shield-ios.json configuration file",
+            type: String,
+            optional: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :no_sign,
+            env_name: "SHIELD_IOS_NO_SIGN",
+            description: "Skip code signing after protection",
+            type: Boolean,
+            default_value: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :verbose,
+            env_name: "SHIELD_IOS_VERBOSE",
+            description: "Enable verbose output",
+            type: Boolean,
+            default_value: false
+          )
+        ]
+      end
+
+      def self.output
+        []
+      end
+
+      def self.return_value
+        nil
+      end
+
+      def self.is_supported?(platform)
+        platform == :ios
+      end
+
+      def self.example_code
+        [
+          'shield_ios(
+            archive_path: "build/MyApp.xcarchive",
+            config: "shield-ios.json"
+          )',
+          'shield_ios(
+            archive_path: "build/MyApp.ipa",
+            output_path: "build/MyApp-protected.ipa",
+            config: "shield-ios.json",
+            no_sign: false,
+            verbose: true
+          )'
+        ]
+      end
+
+      def self.category
+        :code_signing
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/shield_ios/helper/shield_ios_helper.rb

@@ -0,0 +1,33 @@
+require 'fastlane_core/ui/ui'
+
+module Fastlane
+  module Helper
+    class ShieldIosHelper
+      def self.shield_ios_installed?
+        `which shield-ios 2>/dev/null`.strip.length > 0
+      end
+
+      def self.build_command(params)
+        cmd = ["shield-ios", "protect", params[:archive_path].shellescape]
+
+        if params[:output_path]
+          cmd << "--output" << params[:output_path].shellescape
+        end
+
+        if params[:config]
+          cmd << "--config" << params[:config].shellescape
+        end
+
+        if params[:no_sign]
+          cmd << "--no-sign"
+        end
+
+        if params[:verbose]
+          cmd << "--verbose"
+        end
+
+        cmd.join(" ")
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/shield_ios/version.rb

@@ -0,0 +1,5 @@
+module Fastlane
+  module ShieldIos
+    VERSION = "0.1.0"
+  end
+end

data/lib/fastlane/plugin/shield_ios.rb

@@ -0,0 +1,13 @@
+require 'fastlane/plugin/shield_ios/version'
+
+module Fastlane
+  module ShieldIos
+    def self.all_classes
+      Dir[File.expand_path('**/{actions,helper}/*.rb', File.dirname(__FILE__))]
+    end
+  end
+end
+
+Fastlane::ShieldIos.all_classes.each do |current|
+  require current
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: fastlane-plugin-shield_ios
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- ByteHide
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fastlane
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+description: Protect your iOS applications with ByteHide Shield obfuscation, encryption,
+  and runtime security directly from your Fastlane pipeline.
+email:
+- contact@bytehide.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/fastlane/plugin/shield_ios.rb
+- lib/fastlane/plugin/shield_ios/actions/shield_ios_action.rb
+- lib/fastlane/plugin/shield_ios/helper/shield_ios_helper.rb
+- lib/fastlane/plugin/shield_ios/version.rb
+homepage: https://www.bytehide.com
+licenses:
+- Nonstandard
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Fastlane plugin for ByteHide Shield iOS protection
+test_files: []