ruby_android_apk 0.7.7.1

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

data/spec/dex/info_spec.rb

@@ -0,0 +1,121 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+shared_context 'with sample_classes.dex', with: :sample_dex do
+  let(:dex_path){ File.expand_path(File.dirname(__FILE__) + '/../data/sample_classes.dex') }
+  let(:dex_bin){ File.open(dex_path, 'rb') {|f| f.read } }
+  let(:dex){ Android::Dex.new(dex_bin) }
+  let(:last_class) { dex.classes.last }
+end
+describe Android::Dex::ClassInfo do
+  include_context 'with sample_classes.dex'
+  context 'about the last class in Dex#classes with sample_classes.dex' do
+    let(:last_class) { dex.classes.last }
+    its(:name){ should eq 'Lexample/app/sample/SampleCode;' }
+    its(:access_flags){ should be_instance_of Android::Dex::ClassAccessFlag }
+    its(:super_class){ should eq 'Ljava/lang/Object;' }
+    its(:class_data){ should be_instance_of Android::Dex::DexObject::ClassDataItem }
+    its(:class_def){ should be_instance_of Android::Dex::DexObject::ClassDefItem }
+    its(:definition) { should eq 'public class Lexample/app/sample/SampleCode; extends Ljava/lang/Object;' }
+
+    subject { last_class }
+    describe '#static_fields' do
+      subject { last_class.static_fields }
+      it { should have(1).item }
+      specify { subject[0].should be_instance_of Android::Dex::FieldInfo }
+    end
+    describe '#instance_fields' do
+      subject { last_class.instance_fields }
+      it { should have(1).item }
+      specify { subject[0].should be_instance_of Android::Dex::FieldInfo }
+    end
+    describe '#direct_methods' do
+      subject { last_class.direct_methods }
+      it { should have(3).items }
+      specify { subject[0].should be_instance_of Android::Dex::MethodInfo }
+    end
+    describe '#virtual_methods' do
+      subject { last_class.virtual_methods }
+      it { should have(18).items }
+      specify { subject[0].should be_instance_of Android::Dex::MethodInfo }
+    end
+  end
+  context 'when class_data_item is nil' do
+    let(:mock_cls_def) {
+      s = double(Android::Dex::DexObject::ClassDefItem)
+      s.stub(:'[]').with(anything()).and_return(0)
+      s.stub(:class_data_item).and_return(nil)
+      s
+    }
+    let(:class_info) { Android::Dex::ClassInfo.new(mock_cls_def, nil) }
+    describe '#static_fields' do
+      subject { class_info.static_fields }
+      it { should be_kind_of Array }
+      it { should be_empty }
+    end
+    describe '#instance_fields' do
+      subject { class_info.instance_fields }
+      it { should be_kind_of Array }
+      it { should be_empty }
+    end
+    describe '#direct_methods' do
+      subject { class_info.direct_methods }
+      it { should be_kind_of Array }
+      it { should be_empty }
+    end
+    describe '#virtual_methods' do
+      subject { class_info.virtual_methods }
+      it { should be_kind_of Array }
+      it { should be_empty }
+    end
+  end
+end
+
+describe Android::Dex::FieldInfo do
+  include_context 'with sample_classes.dex'
+  context 'about the first static field of the last class with sample_classes.dex'do
+    let(:first_static_field) { last_class.static_fields.first }
+    subject { first_static_field }
+    its(:name) { should eq 'TAG' }
+    its(:type) { should eq 'Ljava/lang/String;' }
+    describe '#access_flags' do
+      subject { first_static_field.access_flags }
+      it { should be_instance_of Android::Dex::ClassAccessFlag }
+      specify { subject.to_s.should eq 'private static final' }
+    end
+    describe '#definition' do
+      subject { first_static_field.definition }
+      it { should eq 'private static final Ljava/lang/String; TAG' }
+    end
+  end
+end
+
+describe Android::Dex::MethodInfo do
+  include_context 'with sample_classes.dex'
+  context 'about the first direct method of the last class' do
+    let(:first_direct_method) { last_class.direct_methods.first }
+    subject { first_direct_method }
+    its(:name) { should eq '<init>' }
+  end
+  context 'about the first virtual method of the last class' do
+    let(:first_virtual_method) { last_class.virtual_methods.first }
+    subject { first_virtual_method }
+    its(:name) { should eq 'processDoWhile' }
+    its(:code_item) { should be_instance_of Android::Dex::DexObject::CodeItem }
+    describe '#parameters' do
+      subject { first_virtual_method.parameters }
+      it { should have(1).item }
+      it { should include('int') }
+    end
+  end
+  context 'about the 12th virtual method(processTryCatch) of the last class' do
+    let(:a_virtual_method) { last_class.virtual_methods[12]}
+    subject { a_virtual_method }
+    its(:name) { should eq 'processTryCatch' }
+    describe '#code_item' do
+      subject { a_virtual_method.code_item }
+      it { should be_instance_of Android::Dex::DexObject::CodeItem }
+      its(:debug_info_item) { should be_instance_of Android::Dex::DexObject::DebugInfoItem }
+    end
+  end
+end
+

data/spec/dex/utils_spec.rb

@@ -0,0 +1,56 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Android::Dex do
+
+  describe ".uleb128" do
+    # @see http://en.wikipedia.org/wiki/LEB128
+    it "[0x00] should be 0" do
+      Android::Dex.uleb128("\x00").should == [0,1]
+    end
+    it "[0x01] should be 1" do
+      Android::Dex.uleb128("\x01").should == [1,1]
+    end
+    it "[0x7f] should be 127" do
+      Android::Dex.uleb128("\x7f").should == [127,1]
+    end
+    it "[0x80,0x7f] should be 16256" do
+      Android::Dex.uleb128("\x80\x7f").should == [16256,2]
+    end
+    it "[0xe5,0x8e,0x26] should be 624485" do
+      Android::Dex.uleb128("\xe5\x8e\x26").should == [624485,3]
+    end
+  end
+
+  describe ".uleb128p1" do
+    it "[0x00] should be -1" do
+      Android::Dex.uleb128p1("\x00").should == [-1,1]
+    end
+    it "[0x01] should be 0" do
+      Android::Dex.uleb128p1("\x01").should == [0,1]
+    end
+    it "[0x7f] should be 126" do
+      Android::Dex.uleb128p1("\x7f").should == [126,1]
+    end
+    it "[0x80,0x7f] should be 16255" do
+      Android::Dex.uleb128p1("\x80\x7f").should == [16255,2]
+    end
+    it "[0xe5,0x8e,0x26] should be 624485" do
+      Android::Dex.uleb128("\xe5\x8e\x26").should == [624485,3]
+    end
+  end
+  describe '.sleb128' do
+    it "[0x00] should be 0" do
+      Android::Dex.sleb128("\x00").should == [0,1]
+    end
+    it "[0x01] should be 1" do
+      Android::Dex.sleb128("\x01").should == [1,1]
+    end
+    it "[0x7f] should be -1" do
+      Android::Dex.sleb128("\x7f").should == [-1,1]
+    end
+    it "[0x80,0x7f] should be 127" do
+      Android::Dex.sleb128("\x80\x7f").should == [-128,2]
+    end
+  end
+end
+

data/spec/dex_spec.rb

@@ -0,0 +1,59 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Android::Dex do
+  let(:dex_path){ File.expand_path(File.dirname(__FILE__) + '/data/sample_classes.dex') }
+  let(:dex_bin){ File.open(dex_path, 'rb') {|f| f.read } }
+  let(:dex){ Android::Dex.new(dex_bin) }
+
+
+  describe '#initialize' do
+    subject { dex }
+    context 'with valid dex data' do
+      it { should be_instance_of(Android::Dex) }
+    end
+    context 'with nil data' do
+      let(:dex_bin) { nil }
+      specify { expect{ subject }.to raise_error  }
+    end
+  end
+
+  describe '#data' do
+    subject { dex.data }
+    it { should be_instance_of String }
+    specify { subject.encoding.should eq Encoding::ASCII_8BIT }
+  end
+
+  describe '#strings' do
+    let(:num_str) { dex.header[:string_ids_size] }
+    subject { dex.strings }
+    it { should be_instance_of Array }
+    it 'should have string_ids_size items' do
+      should have(num_str).items
+    end
+    it "should be the particular string(depends on sample_classes.dex)" do
+      subject[0].should eq "%d"
+    end
+    it "should be the particular string(depends on sample_classes.dex)" do
+      subject[1].should eq "<init>"
+    end
+    it "should be the particular string(depends on sample_classes.dex)" do
+      subject[2].should eq "BuildConfig.java"
+    end
+  end
+    describe '#inspect' do
+      subject { dex.inspect }
+      it { should match(/\A<Android::Dex.*>\Z/m) }
+    end
+
+  describe '#classes' do
+    subject { dex.classes }
+    let(:num_classes) { dex.header[:class_defs_size] }
+    it{ should be_instance_of Array }
+    it{ should have(num_classes).items }
+    describe 'first item' do
+      subject { dex.classes.first }
+      it{ should be_instance_of Android::Dex::ClassInfo }
+    end
+  end
+end
+

data/spec/layout_spec.rb

@@ -0,0 +1,41 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Android::Layout do
+  context 'with real apk sample file' do
+    let(:apk_path){ File.expand_path(File.dirname(__FILE__) + '/data/sample.apk') }
+    let(:apk){ Android::Apk.new(apk_path) }
+    let(:layouts) { apk.layouts }
+    subject { layouts }
+    it { should be_a Hash }
+    it { should have_key "res/layout/main.xml" }
+    it { should have(1).item }
+    context 'about first item' do
+      subject { layouts['res/layout/main.xml'] }
+      it { should be_a Android::Layout }
+      describe '#path' do
+        it { subject.path.should eq 'res/layout/main.xml' }
+      end
+      describe '#doc' do
+        it { subject.doc.should be_a REXML::Document }
+      end
+      describe '#to_xml' do
+        it { subject.to_xml.should be_a String }
+      end
+    end
+  end
+
+  context 'with real new apk sample file' do
+    let(:apk_path){ File.expand_path(File.dirname(__FILE__) + '/data/sample_new.apk') }
+    let(:apk){ Android::Apk.new(apk_path) }
+    let(:layouts) { apk.layouts }
+    subject { layouts }
+    it { should be_a Hash }
+    it { should have_key "res/layout/activity_main.xml" }
+    it { should have(1).item }
+    context 'about first item' do
+      subject { layouts['res/layout/activity_main.xml'] }
+      it { should be_a Android::Layout }
+    end
+  end
+end
+