檢視 Android Getting Started SDK8 的原始碼

== <b>簡介</b> ==
:TAMedia SDK提供Android Mobile App開發者簡易迅速的方式整合行動App廣告, 廣告的種類包含橫幅Banner, 全版Interstitial, Rich Media, 原生性廣告以及InRead廣告, 使用上跟Google Mobile Ads (Admob)類似, 能大量節省開發者學習時間
<br>
== <b>系統需求</b> ==
:Android 4.0.3以上 (API Level 15+), InRead廣告則需Android 5.0以上才能取得廣告 (API Level 21+)
<br>
== <b>Android Studio專案整合SDK</b> ==
請按照下列方式設置專案<br><br>
<big><u>Step 1: 將SDK放入app專案的<b>libs</b>資料夾</u></big><br>
:請至[[Download MADP Android SDK|下載 Download SDK]]下載SDK，並將壓縮檔內的AAR檔 (adpmobile-lib-rx.x.x.aar) 放至專案的libs資料夾, 若無libs資料夾請自行建立<br>

[[檔案:Import_SDK7_Step1-1.PNG]]

<big><u>Step 2-1: 在app的<b>build.gradle</b>的dependencies內加入下列程式 (請根據aar檔名字自行調整)</u></big><br>

[[檔案:Import SDK7 Step2-1.PNG]]

:請加入TAMedia的SDK和Google Play Service的廣告模組，Retrofit函式庫, AndroidX函式庫, Kotlin函式庫, 如需支援Android 4.0作業系統, 請將okhttp版本鎖定在舊版3.12.8解決TLS閃退
  dependencies {
       /* Other dependencies... */
    
     <b>implementation 'com.google.android.gms:play-services-ads-identifier:16.0.0'</b>
     <b>implementation ('com.squareup.retrofit2:retrofit:2.9.0')</b>
     <b>implementation("com.squareup.okhttp3:okhttp:3.12.8") { /* Use old version okhttp to fix TLS crash issue */</b>
     <b>    force = true</b>
     <b>}</b>
     <b>implementation files('libs/adpmobile-lib-rx.x.x.aar')</b>
     <br>
     
     //SDK8
     <b>implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.5.10'</b>
     <b>implementation 'com.squareup.retrofit2:converter-gson:2.9.0'</b>
     <b>implementation 'com.squareup.retrofit2:converter-scalars:2.9.0'</b>
     <b>implementation 'com.google.code.gson:gson:2.8.6'</b>
     <br>
     <b>implementation 'com.jakewharton.retrofit:retrofit2-kotlin-coroutines-adapter:0.9.2'</b>
     <b>implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.4.0-alpha02"</b>
     <b>implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.3.1"</b>
     <b>implementation "androidx.lifecycle:lifecycle-extensions:2.2.0"</b>
     //noinspection LifecycleAnnotationProcessorWithJava8
     <b>annotationProcessor "androidx.lifecycle:lifecycle-compiler:2.3.1"</b>
     <b>implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.0'</b>
     <b>implementation 'androidx.localbroadcastmanager:localbroadcastmanager:1.0.0'</b>
     //SDK8
  }
<br>

:compileOptions請加入JAVA 8
  android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
  }
<br>

<big><u>Step 2-2: 在Project的<b>build.gradle</b>的repositories內加入google()</u></big><br>

[[檔案:Import SDK7 Step2-2.PNG]]

:Google Play Service版本若為11.2+, 必須在repositories新增<b>google()</b>, 這是因為Google Play Service自11.2版本後, 改透過maven.google.com取得<br>SDK8 使用 kotlin 語言，需下載 kotlin 函式庫
  buildscript {
      <b>ext.kotlin_version = "1.5.10"</b>
      repositories {
          <b>google()</b>
          jcenter()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:4.0.1'
          //SDK8 Kotlin
          <b>classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"</b>          
          // NOTE: Do not place your application dependencies here; they belong
          // in the individual module build.gradle files
      }
  }
  
  allprojects {
      repositories {
          <b>google()</b>
          jcenter()
      }
  }
<br><br>

<big><u>Step 3: 在<b>AndroidManifest.xml</b>的manifest tag宣告權限</u></big><br>

[[檔案:Import SDK7 Step3-1.PNG]]

:<ul><li>Required Permission</li></ul>
  &lt;!-- TAMedia Required Permission --&gt;
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <b>&lt;!-- SDK4.0以上版本請移除 --&gt;</b>
:<ul><li>Optional Permission</li></ul>
  &lt;!-- TAMedia Optional Permission -->
  <uses-permission android:name="android.permission.VIBRATE" /> 
  <uses-permission android:name="android.permission.CAMERA" />
  <uses-permission android:name="android.permission.RECORD_AUDIO" />
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<br><br>

<big><u>Step 4: 在<b>AndroidManifest.xml</b>的manifest tag宣告Activity</u></big><br>
  <!-- TAMedia Activity -->
  <activity
     android:name="com.taiwanmobile.pt.adp.view.TWMAdActivity"
     android:configChanges="orientation|keyboardHidden|navigation|keyboard|screenLayout|uiMode|screenSize|smallestScreenSize"
     android:hardwareAccelerated="true"
     android:theme="@android:style/Theme.Translucent" >
  </activity>
<br>
[[Android SDK Developer Guide 2 | 回首頁]]