ruby_android 0.0.2 → 0.7.2

data/ruby_android.gemspec

@@ -1,21 +1,107 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: ruby_android 0.7.2 ruby lib
 
-Gem::Specification.new do |spec|
-  spec.name          = "ruby_android"
-  spec.version       = '0.0.2'
-  spec.authors       = ["Michal Tajchert"]
-  spec.email         = ["thetajchert@gmail.com"]
-  spec.homepage      = 'https://github.com/tajchert/ruby_android'
-  spec.summary       = 'static analysis tool for android apk'
-  spec.description   = 'copy of update ruby_apk'
-  spec.license       = "MIT"
+Gem::Specification.new do |s|
+  s.name = "ruby_android"
+  s.version = "0.7.2"
 
-  spec.files         = `git ls-files -z`.split("\x0")
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors = ["Michal Tajchert", "SecureBrain"]
+  s.date = "2014-08-29"
+  s.description = "static analysis tool for android apk"
+  s.email = "thetajchert@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".idea/.name",
+    ".idea/.rakeTasks",
+    ".idea/encodings.xml",
+    ".idea/misc.xml",
+    ".idea/modules.xml",
+    ".idea/ruby_apk.iml",
+    ".idea/scopes/scope_settings.xml",
+    ".idea/vcs.xml",
+    ".idea/workspace.xml",
+    ".travis.yml",
+    "CHANGELOG.md",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "lib/android/apk.rb",
+    "lib/android/axml_parser.rb",
+    "lib/android/dex.rb",
+    "lib/android/dex/access_flag.rb",
+    "lib/android/dex/dex_object.rb",
+    "lib/android/dex/info.rb",
+    "lib/android/dex/utils.rb",
+    "lib/android/layout.rb",
+    "lib/android/manifest.rb",
+    "lib/android/resource.rb",
+    "lib/android/utils.rb",
+    "lib/ruby_apk.rb",
+    "ruby_android.gemspec",
+    "spec/apk_spec.rb",
+    "spec/axml_parser_spec.rb",
+    "spec/data/sample.apk",
+    "spec/data/sample_AndroidManifest.xml",
+    "spec/data/sample_classes.dex",
+    "spec/data/sample_resources.arsc",
+    "spec/data/sample_resources_utf16.arsc",
+    "spec/data/str_resources.arsc",
+    "spec/dex/access_flag_spec.rb",
+    "spec/dex/dex_object_spec.rb",
+    "spec/dex/info_spec.rb",
+    "spec/dex/utils_spec.rb",
+    "spec/dex_spec.rb",
+    "spec/layout_spec.rb",
+    "spec/manifest_spec.rb",
+    "spec/resource_spec.rb",
+    "spec/ruby_apk_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/utils_spec.rb"
+  ]
+  s.homepage = "https://github.com/tajchert/ruby_apk"
+  s.licenses = ["MIT"]
+  s.rubygems_version = "2.4.1"
+  s.summary = "static analysis tool for android apk"
 
-  spec.add_development_dependency "bundler", '~> 1.7'
-  spec.add_development_dependency "rake", '~> 10.0'
-  spec.add_runtime_dependency "rubyzip", '~> 1.1'
-  spec.add_development_dependency "rspec", '~> 2.11'
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rubyzip>, [">= 1.1.6"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.11.0"])
+      s.add_development_dependency(%q<bundler>, [">= 1.3.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.7"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+      s.add_development_dependency(%q<redcarpet>, [">= 0"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+    else
+      s.add_dependency(%q<rubyzip>, [">= 1.1.6"])
+      s.add_dependency(%q<rspec>, ["~> 2.11.0"])
+      s.add_dependency(%q<bundler>, [">= 1.3.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
+      s.add_dependency(%q<yard>, [">= 0"])
+      s.add_dependency(%q<redcarpet>, [">= 0"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rubyzip>, [">= 1.1.6"])
+    s.add_dependency(%q<rspec>, ["~> 2.11.0"])
+    s.add_dependency(%q<bundler>, [">= 1.3.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
+    s.add_dependency(%q<yard>, [">= 0"])
+    s.add_dependency(%q<redcarpet>, [">= 0"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+  end
 end
+

data/spec/apk_spec.rb

@@ -0,0 +1,301 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'tempfile'
+require 'zip'
+require 'digest/sha1'
+require 'digest/sha2'
+require 'digest/md5'
+
+class TempApk
+  attr_reader :path
+  def initialize
+    @tmp = Tempfile.open('apk_spec')
+    @path = @tmp.path
+    @tmp.close! # delete file
+    append("AndroidManifest.xml", "hogehoge")
+    append("resources.arsc", "hogehoge")
+  end
+  def destroy!
+    File.unlink(@path) if File.exist? @path
+  end
+  def append(entry_name, data)
+    Zip::File.open(@path, Zip::File::CREATE) { |zip|
+      zip.get_output_stream(entry_name) {|f| f.write data }
+    }
+  end
+  def remove(entry_name)
+    Zip::File.open(@path, Zip::File::CREATE) { |zip|
+      zip.remove(entry_name)
+    }
+  end
+end
+
+describe Android::Apk do
+  before do
+    $stderr.reopen('/dev/null','w')
+  end
+  let(:tmp_apk) { TempApk.new }
+  let(:tmp_path) { tmp_apk.path }
+  let(:apk) { Android::Apk.new(tmp_path) }
+  subject { apk }
+
+  after do
+    tmp_apk.destroy!
+  end
+
+  describe "#initialize" do
+    let(:path) { tmp_path }
+    subject { Android::Apk.new(path) }
+    context "with not exist path" do
+      let(:path) { "not exist path" }
+      it { expect{ subject }.to raise_error Android::NotFoundError }
+    end
+    context "with not zip file path" do
+      let(:path) { __FILE__ } # not zip file
+      it { expect{ subject }.to raise_error Android::NotApkFileError }
+    end
+    context "with zip(and non apk) file" do
+      before do
+        tmp_apk.append('hoge.txt', 'hogehoge')
+        tmp_apk.remove('AndroidManifest.xml')
+      end
+      it { expect{ subject }.to raise_error Android::NotApkFileError }
+    end
+    context "with zip includes AndroidManifest.xml" do
+      it { should be_a_instance_of Android::Apk }
+    end
+  end
+
+  describe "#path" do
+    subject { apk.path }
+    it "should equals initialized path" do
+      should == tmp_path
+    end
+  end
+
+  describe "#manifest" do
+    subject { apk.manifest }
+
+    context "when Manifest parse is succeeded." do
+      let(:mock_mani) { mock(Android::Manifest) }
+
+      before do
+      end
+      it "should return manifest object" do
+        Android::Manifest.should_receive(:new).and_return(mock_mani)
+        subject.should == mock_mani
+      end
+    end
+
+    context "when Manifest parse is failed" do
+      it 'should return nil' do
+        Android::Manifest.should_receive(:new).and_raise(Android::AXMLParser::ReadError)
+        subject.should be_nil
+      end
+    end
+  end
+
+  describe "#dex" do
+    let(:mock_dex) { mock(Android::Dex) }
+    subject { apk.dex }
+    context "when there is no dex file" do
+      it { should be_nil }
+    end
+    context "when invalid dex file" do
+      before do
+        tmp_apk.append("classes.dex", "invalid dex")
+      end
+      it { should be_nil }
+    end
+    context "with mock classes.dex file" do
+      before do
+        tmp_apk.append("classes.dex", "mock data")
+      end
+      it "should return mock value" do
+        Android::Dex.should_receive(:new).with("mock data").and_return(mock_dex)
+        subject.should == mock_dex
+      end
+    end
+    context "with real classes.dex file" do
+      before do
+        dex_path = File.expand_path(File.dirname(__FILE__) + '/data/sample_classes.dex')
+        tmp_apk.append("classes.dex", File.open(dex_path, "rb") {|f| f.read })
+      end
+      it { should be_instance_of Android::Dex }
+    end
+  end
+
+  its(:bindata) { should be_instance_of String }
+  describe '#bindata' do
+    specify 'encoding should be ASCII-8BIT' do
+      subject.bindata.encoding.should eq Encoding::ASCII_8BIT 
+    end
+  end
+
+  describe '#resource' do
+    let(:mock_rsc) { mock(Android::Resource) }
+    subject { apk.resource }
+    it "should return manifest object" do
+      Android::Resource.should_receive(:new).and_return(mock_rsc)
+      subject.should == mock_rsc
+    end
+  end
+
+  describe "#size" do
+    subject { apk.size }
+    it "should return apk file size" do 
+      should == File.size(tmp_path)
+    end
+  end
+
+  describe "#digest" do
+    let(:data) { File.open(tmp_apk.path, 'rb'){|f| f.read } }
+    subject { apk.digest(type) }
+    context "when type is sha1" do
+      let(:type) { :sha1 }
+      it "should return sha1 digest" do
+        should eq Digest::SHA1.hexdigest(data)
+      end
+    end
+    context "when type is sha256" do
+      let(:type) { :sha256 }
+      it "should return sha256 digest" do
+        should == Digest::SHA256.hexdigest(data)
+      end
+    end
+    context "when type is md5" do
+      let(:type) { :md5 }
+      it "should return md5 digest" do
+        should == Digest::MD5.hexdigest(data)
+      end
+    end
+    context "when type is unkown symbol" do
+      let(:type) { :unknown }
+      it do
+        expect { subject }.to raise_error(ArgumentError)
+      end
+    end
+    context "when type is not symbol(String: 'sha1')" do
+      let(:type) { 'sha1' }
+      it { expect { subject }.to raise_error(ArgumentError) }
+    end
+  end
+
+  describe '#time' do
+    subject { apk.time }
+    it { should be_kind_of Time }
+  end
+
+  describe "#each_file" do
+    before do
+      tmp_apk.append("hoge.txt", "aaaaaaa")
+    end
+    it { expect { |b| apk.each_file(&b) }.to yield_successive_args(Array, Array, Array) }
+    let(:each_file_result ) {
+      result = []
+      apk.each_file do |name, data|
+        result << [name, data]
+      end
+      result
+    }
+
+    it "should invoke block with all file" do
+      each_file_result.should have(3).items
+      each_file_result.should include(['AndroidManifest.xml', 'hogehoge'])
+      each_file_result.should include(['hoge.txt','aaaaaaa'])
+    end
+  end
+
+  describe '#file' do
+    let(:data) { 'aaaaaaaaaaaaaaaaaaaaaaaaaaa' }
+    let(:path) { 'hoge.txt' }
+    subject { apk.file(path) }
+
+    before do
+      tmp_apk.append('hoge.txt', data)
+    end
+    context 'assigns exist path' do
+      it 'should equal file data' do
+        should eq data
+      end
+    end
+    context 'assigns not exist path' do
+      let(:path) { 'not_exist_path.txt' }
+      it { expect { subject }.to raise_error(Android::NotFoundError) }
+    end
+  end
+
+  describe '#each_entry' do
+    before do
+      tmp_apk.append("hoge.txt", "aaaaaaa")
+    end
+    it { expect { |b| apk.each_entry(&b) }.to yield_successive_args(Zip::Entry, Zip::Entry, Zip::Entry) }
+  end
+
+  describe '#entry' do
+    subject { apk.entry(entry_name) }
+    context 'assigns exist entry' do
+      let(:entry_name) { 'AndroidManifest.xml' }
+      it { should be_instance_of Zip::Entry }
+    end
+    context 'assigns not exist entry name' do
+      let(:entry_name) { 'not_exist_path' }
+      it { expect{ subject }.to raise_error(Android::NotFoundError) }
+    end
+  end
+
+  describe "#find" do
+    before do
+      tmp_apk.append("hoge.txt", "aaaaaaa")
+    end
+    it "should return matched array" do
+      array = apk.find do |name, data|
+        name == "hoge.txt"
+      end
+      array.should be_instance_of Array
+      array.should have(1).item
+      array[0] == "hoge.txt" # returns filename
+    end
+    context "when no entry is matched" do
+      it "should return emtpy array" do
+        array = apk.find do |name, dota|
+          false # nothing matched
+        end
+        array.should be_instance_of Array
+        array.should be_empty
+      end
+    end
+  end
+
+  describe "#icon" do
+    context "with real apk file" do
+      let(:tmp_path){ File.expand_path(File.dirname(__FILE__) + '/data/sample.apk') }
+      subject { apk.icon }
+      it { should be_a Hash }
+      it { should have(3).items }
+      it { subject.keys.should =~ ["res/drawable-hdpi/ic_launcher.png", "res/drawable-ldpi/ic_launcher.png", "res/drawable-mdpi/ic_launcher.png"]
+ }
+    end
+  end
+
+  describe '#signs' do
+    context 'with sampe apk file' do
+      let(:tmp_path){ File.expand_path(File.dirname(__FILE__) + '/data/sample.apk') }
+      subject { apk.signs }
+      it { should be_a Hash }
+      it { should have(1).item }
+      it { should have_key('META-INF/CERT.RSA') }
+      it { subject['META-INF/CERT.RSA'].should be_a OpenSSL::PKCS7 }
+    end
+  end
+
+  describe '#certficates' do
+    context 'with sampe apk file' do
+      let(:tmp_path){ File.expand_path(File.dirname(__FILE__) + '/data/sample.apk') }
+      subject { apk.certificates }
+      it { should be_a Hash }
+      it { should have(1).item }
+      it { should have_key('META-INF/CERT.RSA') }
+      it { subject['META-INF/CERT.RSA'].should be_a OpenSSL::X509::Certificate }
+    end
+  end
+end

data/spec/axml_parser_spec.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Android::AXMLParser do
+  let(:bin_xml_path){ File.expand_path(File.dirname(__FILE__) + '/data/sample_AndroidManifest.xml') }
+  let(:bin_xml){ File.open(bin_xml_path, 'rb') {|f| f.read } }
+  let(:axmlparser){ Android::AXMLParser.new(bin_xml) }
+
+  describe "#parse" do
+
+    subject { axmlparser.parse }
+    context 'with sample_AndroidManifest.xml' do
+      it { should be_instance_of(REXML::Document) }
+      specify 'root element should be <manifest> element' do
+        subject.root.name.should eq 'manifest'
+      end
+      specify 'should have 2 <uses-permission> elements' do
+        subject.get_elements('/manifest/uses-permission').should have(2).items
+      end
+    end
+
+    context 'with nil data as binary xml' do
+      let(:bin_xml) { nil }
+      specify { expect{ subject }.to raise_error }
+    end
+
+  end
+
+  describe "#strings" do
+    context 'with sample_AndroidManifest.xml' do
+      subject { axmlparser.strings }
+      before do
+        axmlparser.parse
+      end
+      it { should be_instance_of(Array) }
+
+      # ugh!! the below test cases depend on sample_AndroidManifest.xml
+      it { should have(26).items} # in sample manifest.
+      it { should include("versionCode") }
+      it { should include("versionName") }
+      it { should include("minSdkVersion") }
+      it { should include("package") }
+      it { should include("manifest") }
+    end
+  end
+
+  describe '#convert_value' do
+    let(:axmlparser){ Android::AXMLParser.new('') }
+    subject { axmlparser.convert_value(str_id, flags, val) }
+    context 'when parsing boolean attribute' do
+      let(:str_id) { 0xFFFFFFFF }
+      let(:flags) { 0x12000008 } 
+      context 'and value is 0x01' do
+        let(:val) { 0x01 }
+        it { should be_true }
+      end
+      context 'and value is 0xFFFFFFF' do
+        let(:val) { 0xFFFFFFFF }
+        it { should be_true }
+      end
+      context 'and value is 0x00' do
+        let(:val) { 0x00 }
+        it { should be_false }
+      end
+    end
+  end
+end

data/spec/dex/access_flag_spec.rb

@@ -0,0 +1,42 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Android::Dex::AccessFlag do
+  let(:flag) { 0x01 }
+  subject { Android::Dex::AccessFlag.new(flag) }
+  its(:flag) { should eq flag }
+end
+
+describe Android::Dex::ClassAccessFlag do
+  let(:accessor) { Android::Dex::ClassAccessFlag.new(flags) }
+
+  subject { accessor.to_s }
+  context 'flags are 0x19(public static final)' do
+    let(:flags) { 0x19 }
+    it { should eq 'public static final' }
+  end
+  context 'flags are 0xc0(volatile transient)' do
+    let(:flags) { 0xc0 }
+    it { should eq 'volatile transient' }
+  end
+  context 'flags are 0x22(private synchronized)' do
+    let(:flags) { 0x22 }
+    it { should eq 'private synchronized' }
+  end
+end
+
+describe Android::Dex::MethodAccessFlag do
+  let(:accessor) { Android::Dex::MethodAccessFlag.new(flags) }
+  subject { accessor.to_s }
+  context 'flags are 0x19(public static final)' do
+    let(:flags) { 0x19 }
+    it { should eq 'public static final' }
+  end
+  context 'flags are 0xc0(bridge varargs)' do
+    let(:flags) { 0xc0 }
+    it { should eq 'bridge varargs' }
+  end
+  context 'flags are 0x22(private synchronized)' do
+    let(:flags) { 0x22 }
+    it { should eq 'private synchronized' }
+  end
+end

data/spec/dex/dex_object_spec.rb

@@ -0,0 +1,118 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Android::Dex do
+  describe Android::Dex::DexObject::Header do
+    let(:header_sample) {
+      sample = 
+        "\x64\x65\x78\x0A\x30\x33\x35\x00\x3F\x14\x98\x2C\x25\x77\x9B\x8D" +
+        "\x7C\xF0\x0B\xFA\x4D\x7B\x03\xAD\x4C\x15\xBC\x31\x4F\xD3\x4B\x71" +
+        "\x58\x18\x00\x00\x70\x00\x00\x00\x78\x56\x34\x12\x00\x00\x00\x00" +
+        "\x00\x00\x00\x00\x88\x17\x00\x00\x7A\x00\x00\x00\x70\x00\x00\x00" +
+        "\x23\x00\x00\x00\x58\x02\x00\x00\x0E\x00\x00\x00\xE4\x02\x00\x00" +
+        "\x10\x00\x00\x00\x8C\x03\x00\x00\x2C\x00\x00\x00\x0C\x04\x00\x00" +
+        "\x0A\x00\x00\x00\x6C\x05\x00\x00\xAC\x11\x00\x00\xAC\x06\x00\x00"
+      sample.force_encoding(Encoding::ASCII_8BIT)
+    }
+    let(:header) { Android::Dex::DexObject::Header.new(header_sample) }
+    describe "#symbols" do
+      subject { header.symbols }
+      it { should be_kind_of(Array) }
+      it { should have(23).items }
+      it { should include(:magic) }
+      it { should include(:checksum) }
+      it { should include(:signature) }
+      it { should include(:file_size) }
+      it { should include(:header_size) }
+      it { should include(:endian_tag) }
+      it { should include(:link_size) }
+      it { should include(:link_off) }
+      it { should include(:map_off) }
+      it { should include(:string_ids_size) }
+      it { should include(:string_ids_off) }
+      it { should include(:type_ids_size) }
+      it { should include(:type_ids_off) }
+      it { should include(:proto_ids_size) }
+      it { should include(:proto_ids_off) }
+      it { should include(:field_ids_size) }
+      it { should include(:field_ids_off) }
+      it { should include(:method_ids_size) }
+      it { should include(:method_ids_off) }
+      it { should include(:class_defs_size) }
+      it { should include(:class_defs_off) }
+      it { should include(:data_size) }
+      it { should include(:data_off) }
+    end
+
+    describe "#[]" do
+      subject { header }
+      it ':magic should be "dex\n035\0"' do 
+        subject[:magic].should ==  "dex\n035\0"
+      end
+      it ":checksum should be 748164159(this value depends on sample_classes.dex)" do
+        subject[:checksum].should == 748164159
+      end
+      it ":signature should be 20byte string" do
+        subject[:signature].should be_kind_of String
+        subject[:signature].length == 20
+      end
+      it ":file_size should be classes.dex file size" do
+        subject[:file_size].should == 6232
+      end
+      it ":header_size should be 0x70" do
+        subject[:header_size].should == 0x70
+      end
+      it "should have integer params" do
+        subject[:header_size].should == 0x70
+      end
+      context "with int symbols" do
+        before do
+          @params = [
+            :link_size,
+            :link_off,
+            :map_off,
+            :string_ids_size,
+            :string_ids_off,
+            :type_ids_size,
+            :type_ids_off,
+            :proto_ids_size,
+            :proto_ids_off,
+            :field_ids_size,
+            :field_ids_off,
+            :method_ids_size,
+            :method_ids_off,
+            :class_defs_size,
+            :class_defs_off,
+            :data_size,
+            :data_off,
+          ]
+        end
+        it "should have integer value" do
+          @params.each do |sym|
+            subject[sym].should be_kind_of Integer
+          end
+        end
+      end
+      context "with unkown params" do
+        it { subject[:unkown].should be_nil }
+      end
+    end
+
+    describe "#inspect" do
+      subject { header.inspect }
+      it { should match(/\A<Android::Dex::DexObject::Header.*>\Z/m) }
+    end
+  end
+
+  describe Android::Dex::DexObject::StringDataItem do
+    let(:string_data_item_sample) {
+      sample = "\x0b\x61\x62\x63\xc0\x80\xc8\x85\xe3\x81\x82\xe3\x81\x84\xe3\x81\x86\xed\xa0\x81\xed\xb0\x80\xc0\x80"
+      sample.force_encoding(Encoding::ASCII_8BIT)
+    }
+    let(:string_data_item) { Android::Dex::DexObject::StringDataItem.new(string_data_item_sample, 0) }
+    describe "#to_s" do
+      subject { string_data_item.to_s }
+      it { should == "abc\u{205}\u{3042}\u{3044}\u{3046}\u{10400}" }
+    end
+  end
+
+end