<?xml version="1.0"?>
<?xml-stylesheet type="text/css" href="https://wiki.adlocus.com/skins/common/feed.css?303"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
		<id>https://wiki.adlocus.com/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Leo+wu</id>
		<title>AdLocus - User contributions [en]</title>
		<link rel="self" type="application/atom+xml" href="https://wiki.adlocus.com/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Leo+wu"/>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Special:Contributions/Leo_wu"/>
		<updated>2026-11-19T19:42:42Z</updated>
		<subtitle>User contributions</subtitle>
		<generator>MediaWiki 1.23.1</generator>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2024-01-24T01:22:53Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* v4.1.43 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.50 ==&lt;br /&gt;
* 修正android 13之後將通知權限送給後台&lt;br /&gt;
* 修正android 14之後鬧鐘&lt;br /&gt;
&lt;br /&gt;
== v4.1.47 ==&lt;br /&gt;
修正android 10之後定位&lt;br /&gt;
&lt;br /&gt;
== v4.1.46 ==&lt;br /&gt;
更新com.google.android.gms:play-services-ads版本 &lt;br /&gt;
== v4.1.45 ==&lt;br /&gt;
增加無隱私權視窗函式&lt;br /&gt;
== v4.1.43 ==&lt;br /&gt;
* 修正廣告顯示增加及設定app名稱&lt;br /&gt;
* 增加預覽推撥顯示測試&lt;br /&gt;
&lt;br /&gt;
== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2024-01-24T01:22:39Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* v4.1.50 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.50 ==&lt;br /&gt;
* 修正android 13之後將通知權限送給後台&lt;br /&gt;
* 修正android 14之後鬧鐘&lt;br /&gt;
&lt;br /&gt;
== v4.1.47 ==&lt;br /&gt;
修正android 10之後定位&lt;br /&gt;
&lt;br /&gt;
== v4.1.46 ==&lt;br /&gt;
更新com.google.android.gms:play-services-ads版本 &lt;br /&gt;
== v4.1.45 ==&lt;br /&gt;
增加無隱私權視窗函式&lt;br /&gt;
== v4.1.43 ==&lt;br /&gt;
修正廣告顯示增加及設定app名稱&lt;br /&gt;
增加預覽推撥顯示測試&lt;br /&gt;
== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2024-01-24T01:22:29Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* v4.1.39 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.50 ==&lt;br /&gt;
修正android 13之後將通知權限送給後台&lt;br /&gt;
修正android 14之後鬧鐘&lt;br /&gt;
&lt;br /&gt;
== v4.1.47 ==&lt;br /&gt;
修正android 10之後定位&lt;br /&gt;
&lt;br /&gt;
== v4.1.46 ==&lt;br /&gt;
更新com.google.android.gms:play-services-ads版本 &lt;br /&gt;
== v4.1.45 ==&lt;br /&gt;
增加無隱私權視窗函式&lt;br /&gt;
== v4.1.43 ==&lt;br /&gt;
修正廣告顯示增加及設定app名稱&lt;br /&gt;
增加預覽推撥顯示測試&lt;br /&gt;
== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2024-01-24T01:22:17Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* v4.1.50 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.50 ==&lt;br /&gt;
修正android 13之後將通知權限送給後台&lt;br /&gt;
修正android 14之後鬧鐘&lt;br /&gt;
&lt;br /&gt;
== v4.1.47 ==&lt;br /&gt;
修正android 10之後定位&lt;br /&gt;
&lt;br /&gt;
== v4.1.46 ==&lt;br /&gt;
更新com.google.android.gms:play-services-ads版本 &lt;br /&gt;
== v4.1.45 ==&lt;br /&gt;
增加無隱私權視窗函式&lt;br /&gt;
== v4.1.43 ==&lt;br /&gt;
修正廣告顯示增加及設定app名稱&lt;br /&gt;
增加預覽推撥顯示測試&lt;br /&gt;
== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2024-01-23T10:33:11Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Hyxen SDK */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.50')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:21.3.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
        //以下方式不會跳出隱私權視窗(V4.1.45)&lt;br /&gt;
        //AdLocus.getInstance(this).registerApp&lt;br /&gt;
        // (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
        //以下方式不會跳出隱私權視窗(V4.1.45)&lt;br /&gt;
        //AdLocus.getInstance(this).registerApp&lt;br /&gt;
        // (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
    AdLocus.SetAppName(this,getString(R.string.app_name));//推撥時顯示app名稱,可移除不設定&lt;br /&gt;
    if(BuildConfig.DEBUG)AdLocus.testAD(this,0);//測試顯示廣告版面,可移除(0-3種類,0:全部)&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example： android 10之後需要驗證ACCESS_BACKGROUND_LOCATION才能取得定位資訊&lt;br /&gt;
* Example： android 13之後需要POST_NOTIFICATIONS才會跳廣告通知&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT&amp;gt;= Build.VERSION_CODES.TIRAMISU ){            &lt;br /&gt;
    if(ActivityCompat.checkSelfPermission(this, android.Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED){&lt;br /&gt;
        ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.POST_NOTIFICATIONS}, TAG_NOTIFICATIONS);&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
                    if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q )ActivityCompat.requestPermissions(RailTimeline.this, new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION}, TAG_LOCATION_BACKGROUND);&lt;br /&gt;
                    else initAdlocus();&lt;br /&gt;
                } else {&lt;br /&gt;
                    initAdlocus();&lt;br /&gt;
                }   &lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
       case TAG_LOCATION_BACKGROUND:&lt;br /&gt;
            initAdlocus();&lt;br /&gt;
            return;&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
* Android 10之後須在message reveiver宣告android:foregroundServiceType才能使用定位&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&lt;br /&gt;
   android:foregroundServiceType=&amp;quot;location&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Android 13之後須在添加 NOTIFICATIONS 權限&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.POST_NOTIFICATIONS&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK</id>
		<title>Android SDK</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK"/>
				<updated>2024-01-23T10:32:50Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* AdLocus SDK 版本：4.1.50 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== AdLocus SDK 版本：4.1.50 ==&lt;br /&gt;
&lt;br /&gt;
* FCM version &lt;br /&gt;
 * [[Android_SDK_Setting| SDK v4.1.50 整合說明文件]]&lt;br /&gt;
&lt;br /&gt;
===AdMob Mediation===&lt;br /&gt;
* [[Media:AdLocusAdapter.java|AdMob Mediation Adapter JAVA 下載]]&lt;br /&gt;
&lt;br /&gt;
===Eclipse整合===&lt;br /&gt;
* [[Eclipse|整合說明]]&lt;br /&gt;
* [[Media:AdLocus_Sample_3_5_6.zip|AdLocus_Sample_3.5.6 下載]]&lt;br /&gt;
&lt;br /&gt;
===更版記錄===&lt;br /&gt;
* [[Android_Changelog|Android更版記錄]]&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2024-01-23T10:32:16Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.50 ==&lt;br /&gt;
修正android 13之後通知權限&lt;br /&gt;
修正android 14之後鬧鐘&lt;br /&gt;
&lt;br /&gt;
== v4.1.47 ==&lt;br /&gt;
修正android 10之後定位&lt;br /&gt;
&lt;br /&gt;
== v4.1.46 ==&lt;br /&gt;
更新com.google.android.gms:play-services-ads版本 &lt;br /&gt;
== v4.1.45 ==&lt;br /&gt;
增加無隱私權視窗函式&lt;br /&gt;
== v4.1.43 ==&lt;br /&gt;
修正廣告顯示增加及設定app名稱&lt;br /&gt;
增加預覽推撥顯示測試&lt;br /&gt;
== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Main_Page</id>
		<title>Main Page</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Main_Page"/>
				<updated>2024-01-23T10:31:02Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Release Note News */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
這是由 AdLocus 提供的開發者 Wiki, 在這裡您可以即時取得 AdLocus 的最新 SDK, 文件, 與使用範例。&lt;br /&gt;
	&lt;br /&gt;
[https://wiki.adlocus.com/images/f/f8/200417_AdLocus_3rdPartyAPP.pdf AdLocus AdLocus第三方介紹簡報]&lt;br /&gt;
&lt;br /&gt;
若您有整合上的問題，以下是我們的聯絡資訊，我們期待您。&lt;br /&gt;
&lt;br /&gt;
* 行動廣告業務與市場及媒體合作&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: sales@adlocus.com&lt;br /&gt;
&lt;br /&gt;
* 開發者諮詢與技術服務諮詢&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: support@adlocus.com&lt;br /&gt;
&lt;br /&gt;
== Release Note News==&lt;br /&gt;
* 2024/01/23 AdLocus Android SDK 4.1.50 釋出&lt;br /&gt;
* 2024/01/08 AdLocus Android SDK 4.1.47 釋出&lt;br /&gt;
* 2022/10/13 AdLocus Android SDK 4.1.46 釋出&lt;br /&gt;
* 2022/09/22 AdLocus Android SDK 4.1.45 釋出&lt;br /&gt;
* 2022/09/13 AdLocus Android SDK 4.1.43 釋出&lt;br /&gt;
* 2022/08/01 AdLocus Android SDK 4.1.42 釋出&lt;br /&gt;
* 2022/07/08 AdLocus Android SDK 4.1.40 釋出&lt;br /&gt;
* 2022/06/29 AdLocus Android SDK 4.1.39 釋出&lt;br /&gt;
* 2022/05/12 AdLocus Android SDK 4.1.37 釋出&lt;br /&gt;
* 2021/12/28 AdLocus Android SDK 4.1.22 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.21 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.19 釋出&lt;br /&gt;
* 2021/07/16 AdLocus Android SDK 4.1.17 釋出&lt;br /&gt;
* 2021/06/17 AdLocus Android SDK 4.1.15 釋出&lt;br /&gt;
* 2021/05/11 AdLocus Android SDK 4.1.14 釋出&lt;br /&gt;
* 2020/08/30 AdLocus Android SDK 4.1.09 釋出&lt;br /&gt;
* 2020/06/30 AdLocus iOS SDK 5.2.0 釋出&lt;br /&gt;
* 2019/11/28 AdLocus Android SDK 4.1.07 釋出 &lt;br /&gt;
* 2016/11/10 AdLocus Android SDK 3.5.7 釋出&lt;br /&gt;
* 2016/06/2 AdLocus iOS SDK 4.1.1(Beta) 釋出&lt;br /&gt;
* 2016/02/25 AdLocus Android SDK 3.5.2 釋出&lt;br /&gt;
* 2016/01/19 AdLocus Android SDK 3.4.2 釋出&lt;br /&gt;
* 2015/07/15 AdLocus Android SDK 3.3.21 釋出&lt;br /&gt;
* 2015/07/08 AdLocus Android SDK 3.3.16 釋出&lt;br /&gt;
* 2015/02/25 AdLocus Android SDK 3.3.7 釋出&lt;br /&gt;
&lt;br /&gt;
== Changelog Note Link==&lt;br /&gt;
* [[iOS_Changelog|iOS_SDK 更新內容匯總]]&lt;br /&gt;
* [[Android_Changelog|And_SDK 更新內容匯總]]&lt;br /&gt;
&lt;br /&gt;
== 使用說明與SDK載點 ==&lt;br /&gt;
* [[Android_SDK|歡迎使用 Android SDK]] &lt;br /&gt;
* [[iOS_SDK|歡迎使用 iOS SDK]]&lt;br /&gt;
* [[Web_SDK|歡迎使用 Web SDK]]&lt;br /&gt;
&lt;br /&gt;
== 開發者Q&amp;amp;A ==&lt;br /&gt;
* [[estimate_income|收入試算]]&lt;br /&gt;
* [[settlement_tax|出帳與稅務]]&lt;br /&gt;
&lt;br /&gt;
== 特定區域主動推播體驗 ==&lt;br /&gt;
&lt;br /&gt;
iOS 文字推播&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://report.adlocus.com/background_fetch_demo.mov&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
InApp展示&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/2/2d/In_app.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/4/4e/%E5%85%A8%E5%B1%8F.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏影音&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;File:SCR_20141006_141437.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[register_auth|註冊＆審核]] ===&lt;br /&gt;
=== [[back_panel|後台使用]] ===&lt;br /&gt;
=== [[advertisement_profit|支援廣告類型]] ===&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!-- === [[document|文件]] === --&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[trick|技巧]] (區域性判斷/使用特定廣告平台/推播服務提示對話框) === &lt;br /&gt;
 格式語法參考：&lt;br /&gt;
=== [[error_code|錯誤碼]] ===&lt;br /&gt;
&lt;br /&gt;
http://zh.wikipedia.org/wiki/Wikipedia:%E6%96%B0%E6%89%8B%E5%85%A5%E9%96%80/%E7%B6%AD%E5%9F%BA%E6%96%87%E6%9C%AC &lt;br /&gt;
http://zh.wikipedia.org/wiki/User:Auvaand/%E7%BB%B4%E5%9F%BA%E8%AF%AD%E6%B3%95&lt;br /&gt;
--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Main_Page</id>
		<title>Main Page</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Main_Page"/>
				<updated>2024-01-23T10:30:18Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Release Note News */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
這是由 AdLocus 提供的開發者 Wiki, 在這裡您可以即時取得 AdLocus 的最新 SDK, 文件, 與使用範例。&lt;br /&gt;
	&lt;br /&gt;
[https://wiki.adlocus.com/images/f/f8/200417_AdLocus_3rdPartyAPP.pdf AdLocus AdLocus第三方介紹簡報]&lt;br /&gt;
&lt;br /&gt;
若您有整合上的問題，以下是我們的聯絡資訊，我們期待您。&lt;br /&gt;
&lt;br /&gt;
* 行動廣告業務與市場及媒體合作&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: sales@adlocus.com&lt;br /&gt;
&lt;br /&gt;
* 開發者諮詢與技術服務諮詢&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: support@adlocus.com&lt;br /&gt;
&lt;br /&gt;
== Release Note News==&lt;br /&gt;
* 2024/01/23 AdLocus Android SDK 4.1.50 釋出&lt;br /&gt;
* 2022/10/13 AdLocus Android SDK 4.1.47 釋出&lt;br /&gt;
* 2022/10/13 AdLocus Android SDK 4.1.46 釋出&lt;br /&gt;
* 2022/09/22 AdLocus Android SDK 4.1.45 釋出&lt;br /&gt;
* 2022/09/13 AdLocus Android SDK 4.1.43 釋出&lt;br /&gt;
* 2022/08/01 AdLocus Android SDK 4.1.42 釋出&lt;br /&gt;
* 2022/07/08 AdLocus Android SDK 4.1.40 釋出&lt;br /&gt;
* 2022/06/29 AdLocus Android SDK 4.1.39 釋出&lt;br /&gt;
* 2022/05/12 AdLocus Android SDK 4.1.37 釋出&lt;br /&gt;
* 2021/12/28 AdLocus Android SDK 4.1.22 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.21 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.19 釋出&lt;br /&gt;
* 2021/07/16 AdLocus Android SDK 4.1.17 釋出&lt;br /&gt;
* 2021/06/17 AdLocus Android SDK 4.1.15 釋出&lt;br /&gt;
* 2021/05/11 AdLocus Android SDK 4.1.14 釋出&lt;br /&gt;
* 2020/08/30 AdLocus Android SDK 4.1.09 釋出&lt;br /&gt;
* 2020/06/30 AdLocus iOS SDK 5.2.0 釋出&lt;br /&gt;
* 2019/11/28 AdLocus Android SDK 4.1.07 釋出 &lt;br /&gt;
* 2016/11/10 AdLocus Android SDK 3.5.7 釋出&lt;br /&gt;
* 2016/06/2 AdLocus iOS SDK 4.1.1(Beta) 釋出&lt;br /&gt;
* 2016/02/25 AdLocus Android SDK 3.5.2 釋出&lt;br /&gt;
* 2016/01/19 AdLocus Android SDK 3.4.2 釋出&lt;br /&gt;
* 2015/07/15 AdLocus Android SDK 3.3.21 釋出&lt;br /&gt;
* 2015/07/08 AdLocus Android SDK 3.3.16 釋出&lt;br /&gt;
* 2015/02/25 AdLocus Android SDK 3.3.7 釋出&lt;br /&gt;
&lt;br /&gt;
== Changelog Note Link==&lt;br /&gt;
* [[iOS_Changelog|iOS_SDK 更新內容匯總]]&lt;br /&gt;
* [[Android_Changelog|And_SDK 更新內容匯總]]&lt;br /&gt;
&lt;br /&gt;
== 使用說明與SDK載點 ==&lt;br /&gt;
* [[Android_SDK|歡迎使用 Android SDK]] &lt;br /&gt;
* [[iOS_SDK|歡迎使用 iOS SDK]]&lt;br /&gt;
* [[Web_SDK|歡迎使用 Web SDK]]&lt;br /&gt;
&lt;br /&gt;
== 開發者Q&amp;amp;A ==&lt;br /&gt;
* [[estimate_income|收入試算]]&lt;br /&gt;
* [[settlement_tax|出帳與稅務]]&lt;br /&gt;
&lt;br /&gt;
== 特定區域主動推播體驗 ==&lt;br /&gt;
&lt;br /&gt;
iOS 文字推播&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://report.adlocus.com/background_fetch_demo.mov&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
InApp展示&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/2/2d/In_app.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/4/4e/%E5%85%A8%E5%B1%8F.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏影音&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;File:SCR_20141006_141437.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[register_auth|註冊＆審核]] ===&lt;br /&gt;
=== [[back_panel|後台使用]] ===&lt;br /&gt;
=== [[advertisement_profit|支援廣告類型]] ===&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!-- === [[document|文件]] === --&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[trick|技巧]] (區域性判斷/使用特定廣告平台/推播服務提示對話框) === &lt;br /&gt;
 格式語法參考：&lt;br /&gt;
=== [[error_code|錯誤碼]] ===&lt;br /&gt;
&lt;br /&gt;
http://zh.wikipedia.org/wiki/Wikipedia:%E6%96%B0%E6%89%8B%E5%85%A5%E9%96%80/%E7%B6%AD%E5%9F%BA%E6%96%87%E6%9C%AC &lt;br /&gt;
http://zh.wikipedia.org/wiki/User:Auvaand/%E7%BB%B4%E5%9F%BA%E8%AF%AD%E6%B3%95&lt;br /&gt;
--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2024-01-08T09:42:03Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Init SDK設置 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.43')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:21.3.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
        //以下方式不會跳出隱私權視窗(V4.1.45)&lt;br /&gt;
        //AdLocus.getInstance(this).registerApp&lt;br /&gt;
        // (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
        //以下方式不會跳出隱私權視窗(V4.1.45)&lt;br /&gt;
        //AdLocus.getInstance(this).registerApp&lt;br /&gt;
        // (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
    AdLocus.SetAppName(this,getString(R.string.app_name));//推撥時顯示app名稱,可移除不設定&lt;br /&gt;
    if(BuildConfig.DEBUG)AdLocus.testAD(this,0);//測試顯示廣告版面,可移除(0-3種類,0:全部)&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example： android 10之後需要驗證ACCESS_BACKGROUND_LOCATION才能取得定位資訊&lt;br /&gt;
* Example： android 13之後需要POST_NOTIFICATIONS才會跳廣告通知&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT&amp;gt;= Build.VERSION_CODES.TIRAMISU ){            &lt;br /&gt;
    if(ActivityCompat.checkSelfPermission(this, android.Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED){&lt;br /&gt;
        ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.POST_NOTIFICATIONS}, TAG_NOTIFICATIONS);&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
                    if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q )ActivityCompat.requestPermissions(RailTimeline.this, new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION}, TAG_LOCATION_BACKGROUND);&lt;br /&gt;
                    else initAdlocus();&lt;br /&gt;
                } else {&lt;br /&gt;
                    initAdlocus();&lt;br /&gt;
                }   &lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
       case TAG_LOCATION_BACKGROUND:&lt;br /&gt;
            initAdlocus();&lt;br /&gt;
            return;&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
* Android 10之後須在message reveiver宣告android:foregroundServiceType才能使用定位&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&lt;br /&gt;
   android:foregroundServiceType=&amp;quot;location&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Android 13之後須在添加 NOTIFICATIONS 權限&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.POST_NOTIFICATIONS&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2024-01-08T09:34:42Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* v4.1.47 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.47 ==&lt;br /&gt;
修正android 10之後定位&lt;br /&gt;
&lt;br /&gt;
== v4.1.46 ==&lt;br /&gt;
更新com.google.android.gms:play-services-ads版本 &lt;br /&gt;
== v4.1.45 ==&lt;br /&gt;
增加無隱私權視窗函式&lt;br /&gt;
== v4.1.43 ==&lt;br /&gt;
修正廣告顯示增加及設定app名稱&lt;br /&gt;
增加預覽推撥顯示測試&lt;br /&gt;
== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK</id>
		<title>Android SDK</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK"/>
				<updated>2024-01-08T09:33:03Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* AdLocus SDK 版本：4.1.4˙ */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== AdLocus SDK 版本：4.1.47 ==&lt;br /&gt;
&lt;br /&gt;
* FCM version &lt;br /&gt;
 * [[Android_SDK_Setting| SDK v4.1.47 整合說明文件]]&lt;br /&gt;
&lt;br /&gt;
===AdMob Mediation===&lt;br /&gt;
* [[Media:AdLocusAdapter.java|AdMob Mediation Adapter JAVA 下載]]&lt;br /&gt;
&lt;br /&gt;
===Eclipse整合===&lt;br /&gt;
* [[Eclipse|整合說明]]&lt;br /&gt;
* [[Media:AdLocus_Sample_3_5_6.zip|AdLocus_Sample_3.5.6 下載]]&lt;br /&gt;
&lt;br /&gt;
===更版記錄===&lt;br /&gt;
* [[Android_Changelog|Android更版記錄]]&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2024-01-08T09:32:20Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.47 ==&lt;br /&gt;
修正android 12定位&lt;br /&gt;
== v4.1.46 ==&lt;br /&gt;
更新com.google.android.gms:play-services-ads版本 &lt;br /&gt;
== v4.1.45 ==&lt;br /&gt;
增加無隱私權視窗函式&lt;br /&gt;
== v4.1.43 ==&lt;br /&gt;
修正廣告顯示增加及設定app名稱&lt;br /&gt;
增加預覽推撥顯示測試&lt;br /&gt;
== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Main_Page</id>
		<title>Main Page</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Main_Page"/>
				<updated>2024-01-08T09:31:00Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Release Note News */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
這是由 AdLocus 提供的開發者 Wiki, 在這裡您可以即時取得 AdLocus 的最新 SDK, 文件, 與使用範例。&lt;br /&gt;
	&lt;br /&gt;
[https://wiki.adlocus.com/images/f/f8/200417_AdLocus_3rdPartyAPP.pdf AdLocus AdLocus第三方介紹簡報]&lt;br /&gt;
&lt;br /&gt;
若您有整合上的問題，以下是我們的聯絡資訊，我們期待您。&lt;br /&gt;
&lt;br /&gt;
* 行動廣告業務與市場及媒體合作&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: sales@adlocus.com&lt;br /&gt;
&lt;br /&gt;
* 開發者諮詢與技術服務諮詢&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: support@adlocus.com&lt;br /&gt;
&lt;br /&gt;
== Release Note News==&lt;br /&gt;
* 2022/10/13 AdLocus Android SDK 4.1.47 釋出&lt;br /&gt;
* 2022/10/13 AdLocus Android SDK 4.1.46 釋出&lt;br /&gt;
* 2022/09/22 AdLocus Android SDK 4.1.45 釋出&lt;br /&gt;
* 2022/09/13 AdLocus Android SDK 4.1.43 釋出&lt;br /&gt;
* 2022/08/01 AdLocus Android SDK 4.1.42 釋出&lt;br /&gt;
* 2022/07/08 AdLocus Android SDK 4.1.40 釋出&lt;br /&gt;
* 2022/06/29 AdLocus Android SDK 4.1.39 釋出&lt;br /&gt;
* 2022/05/12 AdLocus Android SDK 4.1.37 釋出&lt;br /&gt;
* 2021/12/28 AdLocus Android SDK 4.1.22 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.21 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.19 釋出&lt;br /&gt;
* 2021/07/16 AdLocus Android SDK 4.1.17 釋出&lt;br /&gt;
* 2021/06/17 AdLocus Android SDK 4.1.15 釋出&lt;br /&gt;
* 2021/05/11 AdLocus Android SDK 4.1.14 釋出&lt;br /&gt;
* 2020/08/30 AdLocus Android SDK 4.1.09 釋出&lt;br /&gt;
* 2020/06/30 AdLocus iOS SDK 5.2.0 釋出&lt;br /&gt;
* 2019/11/28 AdLocus Android SDK 4.1.07 釋出 &lt;br /&gt;
* 2016/11/10 AdLocus Android SDK 3.5.7 釋出&lt;br /&gt;
* 2016/06/2 AdLocus iOS SDK 4.1.1(Beta) 釋出&lt;br /&gt;
* 2016/02/25 AdLocus Android SDK 3.5.2 釋出&lt;br /&gt;
* 2016/01/19 AdLocus Android SDK 3.4.2 釋出&lt;br /&gt;
* 2015/07/15 AdLocus Android SDK 3.3.21 釋出&lt;br /&gt;
* 2015/07/08 AdLocus Android SDK 3.3.16 釋出&lt;br /&gt;
* 2015/02/25 AdLocus Android SDK 3.3.7 釋出&lt;br /&gt;
&lt;br /&gt;
== Changelog Note Link==&lt;br /&gt;
* [[iOS_Changelog|iOS_SDK 更新內容匯總]]&lt;br /&gt;
* [[Android_Changelog|And_SDK 更新內容匯總]]&lt;br /&gt;
&lt;br /&gt;
== 使用說明與SDK載點 ==&lt;br /&gt;
* [[Android_SDK|歡迎使用 Android SDK]] &lt;br /&gt;
* [[iOS_SDK|歡迎使用 iOS SDK]]&lt;br /&gt;
* [[Web_SDK|歡迎使用 Web SDK]]&lt;br /&gt;
&lt;br /&gt;
== 開發者Q&amp;amp;A ==&lt;br /&gt;
* [[estimate_income|收入試算]]&lt;br /&gt;
* [[settlement_tax|出帳與稅務]]&lt;br /&gt;
&lt;br /&gt;
== 特定區域主動推播體驗 ==&lt;br /&gt;
&lt;br /&gt;
iOS 文字推播&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://report.adlocus.com/background_fetch_demo.mov&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
InApp展示&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/2/2d/In_app.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/4/4e/%E5%85%A8%E5%B1%8F.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏影音&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;File:SCR_20141006_141437.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[register_auth|註冊＆審核]] ===&lt;br /&gt;
=== [[back_panel|後台使用]] ===&lt;br /&gt;
=== [[advertisement_profit|支援廣告類型]] ===&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!-- === [[document|文件]] === --&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[trick|技巧]] (區域性判斷/使用特定廣告平台/推播服務提示對話框) === &lt;br /&gt;
 格式語法參考：&lt;br /&gt;
=== [[error_code|錯誤碼]] ===&lt;br /&gt;
&lt;br /&gt;
http://zh.wikipedia.org/wiki/Wikipedia:%E6%96%B0%E6%89%8B%E5%85%A5%E9%96%80/%E7%B6%AD%E5%9F%BA%E6%96%87%E6%9C%AC &lt;br /&gt;
http://zh.wikipedia.org/wiki/User:Auvaand/%E7%BB%B4%E5%9F%BA%E8%AF%AD%E6%B3%95&lt;br /&gt;
--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Main_Page</id>
		<title>Main Page</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Main_Page"/>
				<updated>2022-10-13T05:39:27Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Release Note News */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
這是由 AdLocus 提供的開發者 Wiki, 在這裡您可以即時取得 AdLocus 的最新 SDK, 文件, 與使用範例。&lt;br /&gt;
	&lt;br /&gt;
[https://wiki.adlocus.com/images/f/f8/200417_AdLocus_3rdPartyAPP.pdf AdLocus AdLocus第三方介紹簡報]&lt;br /&gt;
&lt;br /&gt;
若您有整合上的問題，以下是我們的聯絡資訊，我們期待您。&lt;br /&gt;
&lt;br /&gt;
* 行動廣告業務與市場及媒體合作&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: sales@adlocus.com&lt;br /&gt;
&lt;br /&gt;
* 開發者諮詢與技術服務諮詢&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: support@adlocus.com&lt;br /&gt;
&lt;br /&gt;
== Release Note News==&lt;br /&gt;
* 2022/10/13 AdLocus Android SDK 4.1.46 釋出&lt;br /&gt;
* 2022/09/22 AdLocus Android SDK 4.1.45 釋出&lt;br /&gt;
* 2022/09/13 AdLocus Android SDK 4.1.43 釋出&lt;br /&gt;
* 2022/08/01 AdLocus Android SDK 4.1.42 釋出&lt;br /&gt;
* 2022/07/08 AdLocus Android SDK 4.1.40 釋出&lt;br /&gt;
* 2022/06/29 AdLocus Android SDK 4.1.39 釋出&lt;br /&gt;
* 2022/05/12 AdLocus Android SDK 4.1.37 釋出&lt;br /&gt;
* 2021/12/28 AdLocus Android SDK 4.1.22 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.21 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.19 釋出&lt;br /&gt;
* 2021/07/16 AdLocus Android SDK 4.1.17 釋出&lt;br /&gt;
* 2021/06/17 AdLocus Android SDK 4.1.15 釋出&lt;br /&gt;
* 2021/05/11 AdLocus Android SDK 4.1.14 釋出&lt;br /&gt;
* 2020/08/30 AdLocus Android SDK 4.1.09 釋出&lt;br /&gt;
* 2020/06/30 AdLocus iOS SDK 5.2.0 釋出&lt;br /&gt;
* 2019/11/28 AdLocus Android SDK 4.1.07 釋出 &lt;br /&gt;
* 2016/11/10 AdLocus Android SDK 3.5.7 釋出&lt;br /&gt;
* 2016/06/2 AdLocus iOS SDK 4.1.1(Beta) 釋出&lt;br /&gt;
* 2016/02/25 AdLocus Android SDK 3.5.2 釋出&lt;br /&gt;
* 2016/01/19 AdLocus Android SDK 3.4.2 釋出&lt;br /&gt;
* 2015/07/15 AdLocus Android SDK 3.3.21 釋出&lt;br /&gt;
* 2015/07/08 AdLocus Android SDK 3.3.16 釋出&lt;br /&gt;
* 2015/02/25 AdLocus Android SDK 3.3.7 釋出&lt;br /&gt;
&lt;br /&gt;
== Changelog Note Link==&lt;br /&gt;
* [[iOS_Changelog|iOS_SDK 更新內容匯總]]&lt;br /&gt;
* [[Android_Changelog|And_SDK 更新內容匯總]]&lt;br /&gt;
&lt;br /&gt;
== 使用說明與SDK載點 ==&lt;br /&gt;
* [[Android_SDK|歡迎使用 Android SDK]] &lt;br /&gt;
* [[iOS_SDK|歡迎使用 iOS SDK]]&lt;br /&gt;
* [[Web_SDK|歡迎使用 Web SDK]]&lt;br /&gt;
&lt;br /&gt;
== 開發者Q&amp;amp;A ==&lt;br /&gt;
* [[estimate_income|收入試算]]&lt;br /&gt;
* [[settlement_tax|出帳與稅務]]&lt;br /&gt;
&lt;br /&gt;
== 特定區域主動推播體驗 ==&lt;br /&gt;
&lt;br /&gt;
iOS 文字推播&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://report.adlocus.com/background_fetch_demo.mov&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
InApp展示&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/2/2d/In_app.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/4/4e/%E5%85%A8%E5%B1%8F.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏影音&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;File:SCR_20141006_141437.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[register_auth|註冊＆審核]] ===&lt;br /&gt;
=== [[back_panel|後台使用]] ===&lt;br /&gt;
=== [[advertisement_profit|支援廣告類型]] ===&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!-- === [[document|文件]] === --&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[trick|技巧]] (區域性判斷/使用特定廣告平台/推播服務提示對話框) === &lt;br /&gt;
 格式語法參考：&lt;br /&gt;
=== [[error_code|錯誤碼]] ===&lt;br /&gt;
&lt;br /&gt;
http://zh.wikipedia.org/wiki/Wikipedia:%E6%96%B0%E6%89%8B%E5%85%A5%E9%96%80/%E7%B6%AD%E5%9F%BA%E6%96%87%E6%9C%AC &lt;br /&gt;
http://zh.wikipedia.org/wiki/User:Auvaand/%E7%BB%B4%E5%9F%BA%E8%AF%AD%E6%B3%95&lt;br /&gt;
--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2022-10-13T05:38:46Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.46 ==&lt;br /&gt;
更新com.google.android.gms:play-services-ads版本 &lt;br /&gt;
== v4.1.45 ==&lt;br /&gt;
增加無隱私權視窗函式&lt;br /&gt;
== v4.1.43 ==&lt;br /&gt;
修正廣告顯示增加及設定app名稱&lt;br /&gt;
增加預覽推撥顯示測試&lt;br /&gt;
== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK</id>
		<title>Android SDK</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK"/>
				<updated>2022-10-13T05:37:04Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* AdLocus SDK 版本：4.1.46 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== AdLocus SDK 版本：4.1.46 ==&lt;br /&gt;
&lt;br /&gt;
* FCM version &lt;br /&gt;
 * [[Android_SDK_Setting| SDK v4.1.46 整合說明文件]]&lt;br /&gt;
&lt;br /&gt;
===AdMob Mediation===&lt;br /&gt;
* [[Media:AdLocusAdapter.java|AdMob Mediation Adapter JAVA 下載]]&lt;br /&gt;
&lt;br /&gt;
===Eclipse整合===&lt;br /&gt;
* [[Eclipse|整合說明]]&lt;br /&gt;
* [[Media:AdLocus_Sample_3_5_6.zip|AdLocus_Sample_3.5.6 下載]]&lt;br /&gt;
&lt;br /&gt;
===更版記錄===&lt;br /&gt;
* [[Android_Changelog|Android更版記錄]]&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-10-13T05:36:08Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Google */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.43')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:21.3.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
        //以下方式不會跳出隱私權視窗(V4.1.45)&lt;br /&gt;
        //AdLocus.getInstance(this).registerApp&lt;br /&gt;
        // (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
        //以下方式不會跳出隱私權視窗(V4.1.45)&lt;br /&gt;
        //AdLocus.getInstance(this).registerApp&lt;br /&gt;
        // (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
    AdLocus.SetAppName(this,getString(R.string.app_name));//推撥時顯示app名稱,可移除不設定&lt;br /&gt;
    if(BuildConfig.DEBUG)AdLocus.testAD(this,0);//測試顯示廣告版面,可移除(0-3種類,0:全部)&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example： android 10之後需要驗證ACCESS_BACKGROUND_LOCATION才能取得定位資訊&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
                    if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q )ActivityCompat.requestPermissions(RailTimeline.this, new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION}, TAG_LOCATION_BACKGROUND);&lt;br /&gt;
                    else initAdlocus();&lt;br /&gt;
                } else {&lt;br /&gt;
                    initAdlocus();&lt;br /&gt;
                }   &lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
       case TAG_LOCATION_BACKGROUND:&lt;br /&gt;
            initAdlocus();&lt;br /&gt;
            return;&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
* Android 10之後須在message reveiver宣告android:foregroundServiceType才能使用定位&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&lt;br /&gt;
   android:foregroundServiceType=&amp;quot;location&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-09-23T01:10:18Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Init SDK設置 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.43')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
        //以下方式不會跳出隱私權視窗(V4.1.45)&lt;br /&gt;
        //AdLocus.getInstance(this).registerApp&lt;br /&gt;
        // (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
        //以下方式不會跳出隱私權視窗(V4.1.45)&lt;br /&gt;
        //AdLocus.getInstance(this).registerApp&lt;br /&gt;
        // (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
    AdLocus.SetAppName(this,getString(R.string.app_name));//推撥時顯示app名稱,可移除不設定&lt;br /&gt;
    if(BuildConfig.DEBUG)AdLocus.testAD(this,0);//測試顯示廣告版面,可移除(0-3種類,0:全部)&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example： android 10之後需要驗證ACCESS_BACKGROUND_LOCATION才能取得定位資訊&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
                    if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q )ActivityCompat.requestPermissions(RailTimeline.this, new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION}, TAG_LOCATION_BACKGROUND);&lt;br /&gt;
                    else initAdlocus();&lt;br /&gt;
                } else {&lt;br /&gt;
                    initAdlocus();&lt;br /&gt;
                }   &lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
       case TAG_LOCATION_BACKGROUND:&lt;br /&gt;
            initAdlocus();&lt;br /&gt;
            return;&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
* Android 10之後須在message reveiver宣告android:foregroundServiceType才能使用定位&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&lt;br /&gt;
   android:foregroundServiceType=&amp;quot;location&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK</id>
		<title>Android SDK</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK"/>
				<updated>2022-09-23T01:06:39Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* AdLocus SDK 版本：4.1.45 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== AdLocus SDK 版本：4.1.45 ==&lt;br /&gt;
&lt;br /&gt;
* FCM version &lt;br /&gt;
 * [[Android_SDK_Setting| SDK v4.1.45 整合說明文件]]&lt;br /&gt;
&lt;br /&gt;
===AdMob Mediation===&lt;br /&gt;
* [[Media:AdLocusAdapter.java|AdMob Mediation Adapter JAVA 下載]]&lt;br /&gt;
&lt;br /&gt;
===Eclipse整合===&lt;br /&gt;
* [[Eclipse|整合說明]]&lt;br /&gt;
* [[Media:AdLocus_Sample_3_5_6.zip|AdLocus_Sample_3.5.6 下載]]&lt;br /&gt;
&lt;br /&gt;
===更版記錄===&lt;br /&gt;
* [[Android_Changelog|Android更版記錄]]&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2022-09-23T01:05:52Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.45 ==&lt;br /&gt;
增加無隱私權視窗函式&lt;br /&gt;
== v4.1.43 ==&lt;br /&gt;
修正廣告顯示增加及設定app名稱&lt;br /&gt;
增加預覽推撥顯示測試&lt;br /&gt;
== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Main_Page</id>
		<title>Main Page</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Main_Page"/>
				<updated>2022-09-23T01:04:11Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Release Note News */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
這是由 AdLocus 提供的開發者 Wiki, 在這裡您可以即時取得 AdLocus 的最新 SDK, 文件, 與使用範例。&lt;br /&gt;
	&lt;br /&gt;
[https://wiki.adlocus.com/images/f/f8/200417_AdLocus_3rdPartyAPP.pdf AdLocus AdLocus第三方介紹簡報]&lt;br /&gt;
&lt;br /&gt;
若您有整合上的問題，以下是我們的聯絡資訊，我們期待您。&lt;br /&gt;
&lt;br /&gt;
* 行動廣告業務與市場及媒體合作&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: sales@adlocus.com&lt;br /&gt;
&lt;br /&gt;
* 開發者諮詢與技術服務諮詢&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: support@adlocus.com&lt;br /&gt;
&lt;br /&gt;
== Release Note News==&lt;br /&gt;
* 2022/09/22 AdLocus Android SDK 4.1.45 釋出&lt;br /&gt;
* 2022/09/13 AdLocus Android SDK 4.1.43 釋出&lt;br /&gt;
* 2022/08/01 AdLocus Android SDK 4.1.42 釋出&lt;br /&gt;
* 2022/07/08 AdLocus Android SDK 4.1.40 釋出&lt;br /&gt;
* 2022/06/29 AdLocus Android SDK 4.1.39 釋出&lt;br /&gt;
* 2022/05/12 AdLocus Android SDK 4.1.37 釋出&lt;br /&gt;
* 2021/12/28 AdLocus Android SDK 4.1.22 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.21 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.19 釋出&lt;br /&gt;
* 2021/07/16 AdLocus Android SDK 4.1.17 釋出&lt;br /&gt;
* 2021/06/17 AdLocus Android SDK 4.1.15 釋出&lt;br /&gt;
* 2021/05/11 AdLocus Android SDK 4.1.14 釋出&lt;br /&gt;
* 2020/08/30 AdLocus Android SDK 4.1.09 釋出&lt;br /&gt;
* 2020/06/30 AdLocus iOS SDK 5.2.0 釋出&lt;br /&gt;
* 2019/11/28 AdLocus Android SDK 4.1.07 釋出 &lt;br /&gt;
* 2016/11/10 AdLocus Android SDK 3.5.7 釋出&lt;br /&gt;
* 2016/06/2 AdLocus iOS SDK 4.1.1(Beta) 釋出&lt;br /&gt;
* 2016/02/25 AdLocus Android SDK 3.5.2 釋出&lt;br /&gt;
* 2016/01/19 AdLocus Android SDK 3.4.2 釋出&lt;br /&gt;
* 2015/07/15 AdLocus Android SDK 3.3.21 釋出&lt;br /&gt;
* 2015/07/08 AdLocus Android SDK 3.3.16 釋出&lt;br /&gt;
* 2015/02/25 AdLocus Android SDK 3.3.7 釋出&lt;br /&gt;
&lt;br /&gt;
== Changelog Note Link==&lt;br /&gt;
* [[iOS_Changelog|iOS_SDK 更新內容匯總]]&lt;br /&gt;
* [[Android_Changelog|And_SDK 更新內容匯總]]&lt;br /&gt;
&lt;br /&gt;
== 使用說明與SDK載點 ==&lt;br /&gt;
* [[Android_SDK|歡迎使用 Android SDK]] &lt;br /&gt;
* [[iOS_SDK|歡迎使用 iOS SDK]]&lt;br /&gt;
* [[Web_SDK|歡迎使用 Web SDK]]&lt;br /&gt;
&lt;br /&gt;
== 開發者Q&amp;amp;A ==&lt;br /&gt;
* [[estimate_income|收入試算]]&lt;br /&gt;
* [[settlement_tax|出帳與稅務]]&lt;br /&gt;
&lt;br /&gt;
== 特定區域主動推播體驗 ==&lt;br /&gt;
&lt;br /&gt;
iOS 文字推播&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://report.adlocus.com/background_fetch_demo.mov&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
InApp展示&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/2/2d/In_app.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/4/4e/%E5%85%A8%E5%B1%8F.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏影音&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;File:SCR_20141006_141437.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[register_auth|註冊＆審核]] ===&lt;br /&gt;
=== [[back_panel|後台使用]] ===&lt;br /&gt;
=== [[advertisement_profit|支援廣告類型]] ===&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!-- === [[document|文件]] === --&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[trick|技巧]] (區域性判斷/使用特定廣告平台/推播服務提示對話框) === &lt;br /&gt;
 格式語法參考：&lt;br /&gt;
=== [[error_code|錯誤碼]] ===&lt;br /&gt;
&lt;br /&gt;
http://zh.wikipedia.org/wiki/Wikipedia:%E6%96%B0%E6%89%8B%E5%85%A5%E9%96%80/%E7%B6%AD%E5%9F%BA%E6%96%87%E6%9C%AC &lt;br /&gt;
http://zh.wikipedia.org/wiki/User:Auvaand/%E7%BB%B4%E5%9F%BA%E8%AF%AD%E6%B3%95&lt;br /&gt;
--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-09-13T08:52:56Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Init SDK設置 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.43')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
    AdLocus.SetAppName(this,getString(R.string.app_name));//推撥時顯示app名稱,可移除不設定&lt;br /&gt;
    if(BuildConfig.DEBUG)AdLocus.testAD(this,0);//測試顯示廣告版面,可移除(0-3種類,0:全部)&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example： android 10之後需要驗證ACCESS_BACKGROUND_LOCATION才能取得定位資訊&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
                    if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q )ActivityCompat.requestPermissions(RailTimeline.this, new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION}, TAG_LOCATION_BACKGROUND);&lt;br /&gt;
                    else initAdlocus();&lt;br /&gt;
                } else {&lt;br /&gt;
                    initAdlocus();&lt;br /&gt;
                }   &lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
       case TAG_LOCATION_BACKGROUND:&lt;br /&gt;
            initAdlocus();&lt;br /&gt;
            return;&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
* Android 10之後須在message reveiver宣告android:foregroundServiceType才能使用定位&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&lt;br /&gt;
   android:foregroundServiceType=&amp;quot;location&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-09-13T08:52:13Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Hyxen SDK */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.43')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example： android 10之後需要驗證ACCESS_BACKGROUND_LOCATION才能取得定位資訊&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
                    if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q )ActivityCompat.requestPermissions(RailTimeline.this, new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION}, TAG_LOCATION_BACKGROUND);&lt;br /&gt;
                    else initAdlocus();&lt;br /&gt;
                } else {&lt;br /&gt;
                    initAdlocus();&lt;br /&gt;
                }   &lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
       case TAG_LOCATION_BACKGROUND:&lt;br /&gt;
            initAdlocus();&lt;br /&gt;
            return;&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
* Android 10之後須在message reveiver宣告android:foregroundServiceType才能使用定位&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&lt;br /&gt;
   android:foregroundServiceType=&amp;quot;location&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2022-09-13T08:51:26Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.43 ==&lt;br /&gt;
修正廣告顯示增加及設定app名稱&lt;br /&gt;
增加預覽推撥顯示測試&lt;br /&gt;
== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Main_Page</id>
		<title>Main Page</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Main_Page"/>
				<updated>2022-09-13T08:49:33Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Release Note News */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
這是由 AdLocus 提供的開發者 Wiki, 在這裡您可以即時取得 AdLocus 的最新 SDK, 文件, 與使用範例。&lt;br /&gt;
	&lt;br /&gt;
[https://wiki.adlocus.com/images/f/f8/200417_AdLocus_3rdPartyAPP.pdf AdLocus AdLocus第三方介紹簡報]&lt;br /&gt;
&lt;br /&gt;
若您有整合上的問題，以下是我們的聯絡資訊，我們期待您。&lt;br /&gt;
&lt;br /&gt;
* 行動廣告業務與市場及媒體合作&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: sales@adlocus.com&lt;br /&gt;
&lt;br /&gt;
* 開發者諮詢與技術服務諮詢&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: support@adlocus.com&lt;br /&gt;
&lt;br /&gt;
== Release Note News==&lt;br /&gt;
* 2022/09/13 AdLocus Android SDK 4.1.43 釋出&lt;br /&gt;
* 2022/08/01 AdLocus Android SDK 4.1.42 釋出&lt;br /&gt;
* 2022/07/08 AdLocus Android SDK 4.1.40 釋出&lt;br /&gt;
* 2022/06/29 AdLocus Android SDK 4.1.39 釋出&lt;br /&gt;
* 2022/05/12 AdLocus Android SDK 4.1.37 釋出&lt;br /&gt;
* 2021/12/28 AdLocus Android SDK 4.1.22 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.21 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.19 釋出&lt;br /&gt;
* 2021/07/16 AdLocus Android SDK 4.1.17 釋出&lt;br /&gt;
* 2021/06/17 AdLocus Android SDK 4.1.15 釋出&lt;br /&gt;
* 2021/05/11 AdLocus Android SDK 4.1.14 釋出&lt;br /&gt;
* 2020/08/30 AdLocus Android SDK 4.1.09 釋出&lt;br /&gt;
* 2020/06/30 AdLocus iOS SDK 5.2.0 釋出&lt;br /&gt;
* 2019/11/28 AdLocus Android SDK 4.1.07 釋出 &lt;br /&gt;
* 2016/11/10 AdLocus Android SDK 3.5.7 釋出&lt;br /&gt;
* 2016/06/2 AdLocus iOS SDK 4.1.1(Beta) 釋出&lt;br /&gt;
* 2016/02/25 AdLocus Android SDK 3.5.2 釋出&lt;br /&gt;
* 2016/01/19 AdLocus Android SDK 3.4.2 釋出&lt;br /&gt;
* 2015/07/15 AdLocus Android SDK 3.3.21 釋出&lt;br /&gt;
* 2015/07/08 AdLocus Android SDK 3.3.16 釋出&lt;br /&gt;
* 2015/02/25 AdLocus Android SDK 3.3.7 釋出&lt;br /&gt;
&lt;br /&gt;
== Changelog Note Link==&lt;br /&gt;
* [[iOS_Changelog|iOS_SDK 更新內容匯總]]&lt;br /&gt;
* [[Android_Changelog|And_SDK 更新內容匯總]]&lt;br /&gt;
&lt;br /&gt;
== 使用說明與SDK載點 ==&lt;br /&gt;
* [[Android_SDK|歡迎使用 Android SDK]] &lt;br /&gt;
* [[iOS_SDK|歡迎使用 iOS SDK]]&lt;br /&gt;
* [[Web_SDK|歡迎使用 Web SDK]]&lt;br /&gt;
&lt;br /&gt;
== 開發者Q&amp;amp;A ==&lt;br /&gt;
* [[estimate_income|收入試算]]&lt;br /&gt;
* [[settlement_tax|出帳與稅務]]&lt;br /&gt;
&lt;br /&gt;
== 特定區域主動推播體驗 ==&lt;br /&gt;
&lt;br /&gt;
iOS 文字推播&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://report.adlocus.com/background_fetch_demo.mov&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
InApp展示&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/2/2d/In_app.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/4/4e/%E5%85%A8%E5%B1%8F.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏影音&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;File:SCR_20141006_141437.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[register_auth|註冊＆審核]] ===&lt;br /&gt;
=== [[back_panel|後台使用]] ===&lt;br /&gt;
=== [[advertisement_profit|支援廣告類型]] ===&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!-- === [[document|文件]] === --&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[trick|技巧]] (區域性判斷/使用特定廣告平台/推播服務提示對話框) === &lt;br /&gt;
 格式語法參考：&lt;br /&gt;
=== [[error_code|錯誤碼]] ===&lt;br /&gt;
&lt;br /&gt;
http://zh.wikipedia.org/wiki/Wikipedia:%E6%96%B0%E6%89%8B%E5%85%A5%E9%96%80/%E7%B6%AD%E5%9F%BA%E6%96%87%E6%9C%AC &lt;br /&gt;
http://zh.wikipedia.org/wiki/User:Auvaand/%E7%BB%B4%E5%9F%BA%E8%AF%AD%E6%B3%95&lt;br /&gt;
--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-08-04T03:59:03Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Init SDK設置 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.42')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example： android 10之後需要驗證ACCESS_BACKGROUND_LOCATION才能取得定位資訊&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
                    if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q )ActivityCompat.requestPermissions(RailTimeline.this, new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION}, TAG_LOCATION_BACKGROUND);&lt;br /&gt;
                    else initAdlocus();&lt;br /&gt;
                } else {&lt;br /&gt;
                    initAdlocus();&lt;br /&gt;
                }   &lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
       case TAG_LOCATION_BACKGROUND:&lt;br /&gt;
            initAdlocus();&lt;br /&gt;
            return;&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
* Android 10之後須在message reveiver宣告android:foregroundServiceType才能使用定位&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&lt;br /&gt;
   android:foregroundServiceType=&amp;quot;location&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-08-04T03:38:57Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Init SDK設置 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.42')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
                    if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q )ActivityCompat.requestPermissions(RailTimeline.this, new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION}, TAG_LOCATION_BACKGROUND);&lt;br /&gt;
                    else initAdlocus();&lt;br /&gt;
                } else {&lt;br /&gt;
                    initAdlocus();&lt;br /&gt;
                }   &lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
       case TAG_LOCATION_BACKGROUND:&lt;br /&gt;
            initAdlocus();&lt;br /&gt;
            return;&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-08-04T03:35:48Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Init SDK設置 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.42')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT &amp;gt;= Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           // If request is cancelled, the result arrays are empty.&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
           } else {&lt;br /&gt;
           }&lt;br /&gt;
           initAdlocus();&lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-08-04T03:34:11Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Init SDK設置 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.42')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT&amp;lt; Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           // If request is cancelled, the result arrays are empty.&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
           } else {&lt;br /&gt;
           }&lt;br /&gt;
           initAdlocus();&lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-08-04T03:33:32Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Init SDK設置 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.42')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
boolean isReqBackAccess=true;&lt;br /&gt;
if(android.os.Build.VERSION.SDK_INT&amp;lt; Build.VERSION_CODES.Q ){&lt;br /&gt;
    isReqBackAccess=ActivityCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;&lt;br /&gt;
}&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; isReqBackAccess) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           // If request is cancelled, the result arrays are empty.&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
           } else {&lt;br /&gt;
           }&lt;br /&gt;
           initAdlocus();&lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-08-04T03:24:35Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Hyxen SDK */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.42')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           // If request is cancelled, the result arrays are empty.&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
           } else {&lt;br /&gt;
           }&lt;br /&gt;
           initAdlocus();&lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK</id>
		<title>Android SDK</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK"/>
				<updated>2022-08-04T03:24:17Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* AdLocus SDK 版本：4.1.40 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== AdLocus SDK 版本：4.1.42 ==&lt;br /&gt;
&lt;br /&gt;
* FCM version &lt;br /&gt;
 * [[Android_SDK_Setting| SDK v4.1.42 整合說明文件]]&lt;br /&gt;
&lt;br /&gt;
===AdMob Mediation===&lt;br /&gt;
* [[Media:AdLocusAdapter.java|AdMob Mediation Adapter JAVA 下載]]&lt;br /&gt;
&lt;br /&gt;
===Eclipse整合===&lt;br /&gt;
* [[Eclipse|整合說明]]&lt;br /&gt;
* [[Media:AdLocus_Sample_3_5_6.zip|AdLocus_Sample_3.5.6 下載]]&lt;br /&gt;
&lt;br /&gt;
===更版記錄===&lt;br /&gt;
* [[Android_Changelog|Android更版記錄]]&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2022-08-04T03:23:28Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.42 ==&lt;br /&gt;
修正定位及同意隱私權視窗&lt;br /&gt;
== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Main_Page</id>
		<title>Main Page</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Main_Page"/>
				<updated>2022-08-04T03:21:31Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Release Note News */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
這是由 AdLocus 提供的開發者 Wiki, 在這裡您可以即時取得 AdLocus 的最新 SDK, 文件, 與使用範例。&lt;br /&gt;
	&lt;br /&gt;
[https://wiki.adlocus.com/images/f/f8/200417_AdLocus_3rdPartyAPP.pdf AdLocus AdLocus第三方介紹簡報]&lt;br /&gt;
&lt;br /&gt;
若您有整合上的問題，以下是我們的聯絡資訊，我們期待您。&lt;br /&gt;
&lt;br /&gt;
* 行動廣告業務與市場及媒體合作&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: sales@adlocus.com&lt;br /&gt;
&lt;br /&gt;
* 開發者諮詢與技術服務諮詢&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: support@adlocus.com&lt;br /&gt;
&lt;br /&gt;
== Release Note News==&lt;br /&gt;
* 2022/08/01 AdLocus Android SDK 4.1.42 釋出&lt;br /&gt;
* 2022/07/08 AdLocus Android SDK 4.1.40 釋出&lt;br /&gt;
* 2022/06/29 AdLocus Android SDK 4.1.39 釋出&lt;br /&gt;
* 2022/05/12 AdLocus Android SDK 4.1.37 釋出&lt;br /&gt;
* 2021/12/28 AdLocus Android SDK 4.1.22 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.21 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.19 釋出&lt;br /&gt;
* 2021/07/16 AdLocus Android SDK 4.1.17 釋出&lt;br /&gt;
* 2021/06/17 AdLocus Android SDK 4.1.15 釋出&lt;br /&gt;
* 2021/05/11 AdLocus Android SDK 4.1.14 釋出&lt;br /&gt;
* 2020/08/30 AdLocus Android SDK 4.1.09 釋出&lt;br /&gt;
* 2020/06/30 AdLocus iOS SDK 5.2.0 釋出&lt;br /&gt;
* 2019/11/28 AdLocus Android SDK 4.1.07 釋出 &lt;br /&gt;
* 2016/11/10 AdLocus Android SDK 3.5.7 釋出&lt;br /&gt;
* 2016/06/2 AdLocus iOS SDK 4.1.1(Beta) 釋出&lt;br /&gt;
* 2016/02/25 AdLocus Android SDK 3.5.2 釋出&lt;br /&gt;
* 2016/01/19 AdLocus Android SDK 3.4.2 釋出&lt;br /&gt;
* 2015/07/15 AdLocus Android SDK 3.3.21 釋出&lt;br /&gt;
* 2015/07/08 AdLocus Android SDK 3.3.16 釋出&lt;br /&gt;
* 2015/02/25 AdLocus Android SDK 3.3.7 釋出&lt;br /&gt;
&lt;br /&gt;
== Changelog Note Link==&lt;br /&gt;
* [[iOS_Changelog|iOS_SDK 更新內容匯總]]&lt;br /&gt;
* [[Android_Changelog|And_SDK 更新內容匯總]]&lt;br /&gt;
&lt;br /&gt;
== 使用說明與SDK載點 ==&lt;br /&gt;
* [[Android_SDK|歡迎使用 Android SDK]] &lt;br /&gt;
* [[iOS_SDK|歡迎使用 iOS SDK]]&lt;br /&gt;
* [[Web_SDK|歡迎使用 Web SDK]]&lt;br /&gt;
&lt;br /&gt;
== 開發者Q&amp;amp;A ==&lt;br /&gt;
* [[estimate_income|收入試算]]&lt;br /&gt;
* [[settlement_tax|出帳與稅務]]&lt;br /&gt;
&lt;br /&gt;
== 特定區域主動推播體驗 ==&lt;br /&gt;
&lt;br /&gt;
iOS 文字推播&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://report.adlocus.com/background_fetch_demo.mov&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
InApp展示&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/2/2d/In_app.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/4/4e/%E5%85%A8%E5%B1%8F.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏影音&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;File:SCR_20141006_141437.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[register_auth|註冊＆審核]] ===&lt;br /&gt;
=== [[back_panel|後台使用]] ===&lt;br /&gt;
=== [[advertisement_profit|支援廣告類型]] ===&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!-- === [[document|文件]] === --&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[trick|技巧]] (區域性判斷/使用特定廣告平台/推播服務提示對話框) === &lt;br /&gt;
 格式語法參考：&lt;br /&gt;
=== [[error_code|錯誤碼]] ===&lt;br /&gt;
&lt;br /&gt;
http://zh.wikipedia.org/wiki/Wikipedia:%E6%96%B0%E6%89%8B%E5%85%A5%E9%96%80/%E7%B6%AD%E5%9F%BA%E6%96%87%E6%9C%AC &lt;br /&gt;
http://zh.wikipedia.org/wiki/User:Auvaand/%E7%BB%B4%E5%9F%BA%E8%AF%AD%E6%B3%95&lt;br /&gt;
--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-07-12T09:42:38Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* 備註 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.40')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           // If request is cancelled, the result arrays are empty.&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
           } else {&lt;br /&gt;
           }&lt;br /&gt;
           initAdlocus();&lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* android 13(API 32)之後須加入權限 com.google.android.gms.permission.AD_ID&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;com.google.android.gms.permission.AD_ID&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2022-07-12T08:08:32Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* v4.1.40 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE_STATE&lt;br /&gt;
&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-07-12T08:06:49Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Hyxen SDK */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.40')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           // If request is cancelled, the result arrays are empty.&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
           } else {&lt;br /&gt;
           }&lt;br /&gt;
           initAdlocus();&lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK</id>
		<title>Android SDK</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK"/>
				<updated>2022-07-12T08:06:33Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* AdLocus SDK 版本：4.1.40 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== AdLocus SDK 版本：4.1.40 ==&lt;br /&gt;
&lt;br /&gt;
* FCM version &lt;br /&gt;
 * [[Android_SDK_Setting| SDK v4.1.40 整合說明文件]]&lt;br /&gt;
&lt;br /&gt;
===AdMob Mediation===&lt;br /&gt;
* [[Media:AdLocusAdapter.java|AdMob Mediation Adapter JAVA 下載]]&lt;br /&gt;
&lt;br /&gt;
===Eclipse整合===&lt;br /&gt;
* [[Eclipse|整合說明]]&lt;br /&gt;
* [[Media:AdLocus_Sample_3_5_6.zip|AdLocus_Sample_3.5.6 下載]]&lt;br /&gt;
&lt;br /&gt;
===更版記錄===&lt;br /&gt;
* [[Android_Changelog|Android更版記錄]]&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2022-07-12T08:05:11Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.40 ==&lt;br /&gt;
移除預設權限READ_PHONE&lt;br /&gt;
== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Main_Page</id>
		<title>Main Page</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Main_Page"/>
				<updated>2022-07-12T08:04:10Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Release Note News */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
這是由 AdLocus 提供的開發者 Wiki, 在這裡您可以即時取得 AdLocus 的最新 SDK, 文件, 與使用範例。&lt;br /&gt;
	&lt;br /&gt;
[https://wiki.adlocus.com/images/f/f8/200417_AdLocus_3rdPartyAPP.pdf AdLocus AdLocus第三方介紹簡報]&lt;br /&gt;
&lt;br /&gt;
若您有整合上的問題，以下是我們的聯絡資訊，我們期待您。&lt;br /&gt;
&lt;br /&gt;
* 行動廣告業務與市場及媒體合作&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: sales@adlocus.com&lt;br /&gt;
&lt;br /&gt;
* 開發者諮詢與技術服務諮詢&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: support@adlocus.com&lt;br /&gt;
&lt;br /&gt;
== Release Note News==&lt;br /&gt;
* 2022/07/08 AdLocus Android SDK 4.1.40 釋出&lt;br /&gt;
* 2022/06/29 AdLocus Android SDK 4.1.39 釋出&lt;br /&gt;
* 2022/05/12 AdLocus Android SDK 4.1.37 釋出&lt;br /&gt;
* 2021/12/28 AdLocus Android SDK 4.1.22 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.21 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.19 釋出&lt;br /&gt;
* 2021/07/16 AdLocus Android SDK 4.1.17 釋出&lt;br /&gt;
* 2021/06/17 AdLocus Android SDK 4.1.15 釋出&lt;br /&gt;
* 2021/05/11 AdLocus Android SDK 4.1.14 釋出&lt;br /&gt;
* 2020/08/30 AdLocus Android SDK 4.1.09 釋出&lt;br /&gt;
* 2020/06/30 AdLocus iOS SDK 5.2.0 釋出&lt;br /&gt;
* 2019/11/28 AdLocus Android SDK 4.1.07 釋出 &lt;br /&gt;
* 2016/11/10 AdLocus Android SDK 3.5.7 釋出&lt;br /&gt;
* 2016/06/2 AdLocus iOS SDK 4.1.1(Beta) 釋出&lt;br /&gt;
* 2016/02/25 AdLocus Android SDK 3.5.2 釋出&lt;br /&gt;
* 2016/01/19 AdLocus Android SDK 3.4.2 釋出&lt;br /&gt;
* 2015/07/15 AdLocus Android SDK 3.3.21 釋出&lt;br /&gt;
* 2015/07/08 AdLocus Android SDK 3.3.16 釋出&lt;br /&gt;
* 2015/02/25 AdLocus Android SDK 3.3.7 釋出&lt;br /&gt;
&lt;br /&gt;
== Changelog Note Link==&lt;br /&gt;
* [[iOS_Changelog|iOS_SDK 更新內容匯總]]&lt;br /&gt;
* [[Android_Changelog|And_SDK 更新內容匯總]]&lt;br /&gt;
&lt;br /&gt;
== 使用說明與SDK載點 ==&lt;br /&gt;
* [[Android_SDK|歡迎使用 Android SDK]] &lt;br /&gt;
* [[iOS_SDK|歡迎使用 iOS SDK]]&lt;br /&gt;
* [[Web_SDK|歡迎使用 Web SDK]]&lt;br /&gt;
&lt;br /&gt;
== 開發者Q&amp;amp;A ==&lt;br /&gt;
* [[estimate_income|收入試算]]&lt;br /&gt;
* [[settlement_tax|出帳與稅務]]&lt;br /&gt;
&lt;br /&gt;
== 特定區域主動推播體驗 ==&lt;br /&gt;
&lt;br /&gt;
iOS 文字推播&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://report.adlocus.com/background_fetch_demo.mov&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
InApp展示&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/2/2d/In_app.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/4/4e/%E5%85%A8%E5%B1%8F.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏影音&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;File:SCR_20141006_141437.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[register_auth|註冊＆審核]] ===&lt;br /&gt;
=== [[back_panel|後台使用]] ===&lt;br /&gt;
=== [[advertisement_profit|支援廣告類型]] ===&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!-- === [[document|文件]] === --&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[trick|技巧]] (區域性判斷/使用特定廣告平台/推播服務提示對話框) === &lt;br /&gt;
 格式語法參考：&lt;br /&gt;
=== [[error_code|錯誤碼]] ===&lt;br /&gt;
&lt;br /&gt;
http://zh.wikipedia.org/wiki/Wikipedia:%E6%96%B0%E6%89%8B%E5%85%A5%E9%96%80/%E7%B6%AD%E5%9F%BA%E6%96%87%E6%9C%AC &lt;br /&gt;
http://zh.wikipedia.org/wiki/User:Auvaand/%E7%BB%B4%E5%9F%BA%E8%AF%AD%E6%B3%95&lt;br /&gt;
--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Main_Page</id>
		<title>Main Page</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Main_Page"/>
				<updated>2022-07-05T02:38:36Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Release Note News */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
這是由 AdLocus 提供的開發者 Wiki, 在這裡您可以即時取得 AdLocus 的最新 SDK, 文件, 與使用範例。&lt;br /&gt;
	&lt;br /&gt;
[https://wiki.adlocus.com/images/f/f8/200417_AdLocus_3rdPartyAPP.pdf AdLocus AdLocus第三方介紹簡報]&lt;br /&gt;
&lt;br /&gt;
若您有整合上的問題，以下是我們的聯絡資訊，我們期待您。&lt;br /&gt;
&lt;br /&gt;
* 行動廣告業務與市場及媒體合作&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: sales@adlocus.com&lt;br /&gt;
&lt;br /&gt;
* 開發者諮詢與技術服務諮詢&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: support@adlocus.com&lt;br /&gt;
&lt;br /&gt;
== Release Note News==&lt;br /&gt;
* 2022/06/29 AdLocus Android SDK 4.1.39 釋出&lt;br /&gt;
* 2022/05/12 AdLocus Android SDK 4.1.37 釋出&lt;br /&gt;
* 2021/12/28 AdLocus Android SDK 4.1.22 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.21 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.19 釋出&lt;br /&gt;
* 2021/07/16 AdLocus Android SDK 4.1.17 釋出&lt;br /&gt;
* 2021/06/17 AdLocus Android SDK 4.1.15 釋出&lt;br /&gt;
* 2021/05/11 AdLocus Android SDK 4.1.14 釋出&lt;br /&gt;
* 2020/08/30 AdLocus Android SDK 4.1.09 釋出&lt;br /&gt;
* 2020/06/30 AdLocus iOS SDK 5.2.0 釋出&lt;br /&gt;
* 2019/11/28 AdLocus Android SDK 4.1.07 釋出 &lt;br /&gt;
* 2016/11/10 AdLocus Android SDK 3.5.7 釋出&lt;br /&gt;
* 2016/06/2 AdLocus iOS SDK 4.1.1(Beta) 釋出&lt;br /&gt;
* 2016/02/25 AdLocus Android SDK 3.5.2 釋出&lt;br /&gt;
* 2016/01/19 AdLocus Android SDK 3.4.2 釋出&lt;br /&gt;
* 2015/07/15 AdLocus Android SDK 3.3.21 釋出&lt;br /&gt;
* 2015/07/08 AdLocus Android SDK 3.3.16 釋出&lt;br /&gt;
* 2015/02/25 AdLocus Android SDK 3.3.7 釋出&lt;br /&gt;
&lt;br /&gt;
== Changelog Note Link==&lt;br /&gt;
* [[iOS_Changelog|iOS_SDK 更新內容匯總]]&lt;br /&gt;
* [[Android_Changelog|And_SDK 更新內容匯總]]&lt;br /&gt;
&lt;br /&gt;
== 使用說明與SDK載點 ==&lt;br /&gt;
* [[Android_SDK|歡迎使用 Android SDK]] &lt;br /&gt;
* [[iOS_SDK|歡迎使用 iOS SDK]]&lt;br /&gt;
* [[Web_SDK|歡迎使用 Web SDK]]&lt;br /&gt;
&lt;br /&gt;
== 開發者Q&amp;amp;A ==&lt;br /&gt;
* [[estimate_income|收入試算]]&lt;br /&gt;
* [[settlement_tax|出帳與稅務]]&lt;br /&gt;
&lt;br /&gt;
== 特定區域主動推播體驗 ==&lt;br /&gt;
&lt;br /&gt;
iOS 文字推播&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://report.adlocus.com/background_fetch_demo.mov&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
InApp展示&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/2/2d/In_app.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/4/4e/%E5%85%A8%E5%B1%8F.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏影音&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;File:SCR_20141006_141437.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[register_auth|註冊＆審核]] ===&lt;br /&gt;
=== [[back_panel|後台使用]] ===&lt;br /&gt;
=== [[advertisement_profit|支援廣告類型]] ===&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!-- === [[document|文件]] === --&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[trick|技巧]] (區域性判斷/使用特定廣告平台/推播服務提示對話框) === &lt;br /&gt;
 格式語法參考：&lt;br /&gt;
=== [[error_code|錯誤碼]] ===&lt;br /&gt;
&lt;br /&gt;
http://zh.wikipedia.org/wiki/Wikipedia:%E6%96%B0%E6%89%8B%E5%85%A5%E9%96%80/%E7%B6%AD%E5%9F%BA%E6%96%87%E6%9C%AC &lt;br /&gt;
http://zh.wikipedia.org/wiki/User:Auvaand/%E7%BB%B4%E5%9F%BA%E8%AF%AD%E6%B3%95&lt;br /&gt;
--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2022-07-05T02:34:54Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.39 ==&lt;br /&gt;
* 修正更新app後流量損失&lt;br /&gt;
== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-07-05T02:33:16Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Dependency lib */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.39')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           // If request is cancelled, the result arrays are empty.&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
           } else {&lt;br /&gt;
           }&lt;br /&gt;
           initAdlocus();&lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK</id>
		<title>Android SDK</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK"/>
				<updated>2022-07-05T02:32:48Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* AdLocus SDK 版本：4.1.37 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
== AdLocus SDK 版本：4.1.39 ==&lt;br /&gt;
&lt;br /&gt;
* FCM version &lt;br /&gt;
 * [[Android_SDK_Setting| SDK v4.1.39 整合說明文件]]&lt;br /&gt;
&lt;br /&gt;
===AdMob Mediation===&lt;br /&gt;
* [[Media:AdLocusAdapter.java|AdMob Mediation Adapter JAVA 下載]]&lt;br /&gt;
&lt;br /&gt;
===Eclipse整合===&lt;br /&gt;
* [[Eclipse|整合說明]]&lt;br /&gt;
* [[Media:AdLocus_Sample_3_5_6.zip|AdLocus_Sample_3.5.6 下載]]&lt;br /&gt;
&lt;br /&gt;
===更版記錄===&lt;br /&gt;
* [[Android_Changelog|Android更版記錄]]&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-05-13T01:48:48Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* 備註 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.37')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           // If request is cancelled, the result arrays are empty.&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
           } else {&lt;br /&gt;
           }&lt;br /&gt;
           initAdlocus();&lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.37 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.37版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2022-05-13T01:48:04Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* v4.1.37 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
* 修正android 12閃退&lt;br /&gt;
&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_Changelog</id>
		<title>Android Changelog</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_Changelog"/>
				<updated>2022-05-12T07:17:44Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== v4.1.37 ==&lt;br /&gt;
* 移除資料蒐集及應用程式列表&lt;br /&gt;
== v4.1.22 ==&lt;br /&gt;
* fcm key可帶入空白&lt;br /&gt;
* 新增READ_PHONE_STATE權限&lt;br /&gt;
== v4.1.21 ==&lt;br /&gt;
* 隱私權視窗說明及相關資料屏蔽&lt;br /&gt;
== v4.1.19 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.17 ==&lt;br /&gt;
* 修正CM設定&lt;br /&gt;
== v4.1.14 ==&lt;br /&gt;
* SDK放上 mavenCentra&lt;br /&gt;
== v4.1.09 ==&lt;br /&gt;
* 修正 Webviews 跳轉問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.08 ==&lt;br /&gt;
* 修正LOG檔案累積問題&lt;br /&gt;
&lt;br /&gt;
== v4.1.07 ==&lt;br /&gt;
* 修正安全性警示問題&lt;br /&gt;
&lt;br /&gt;
== v3.5.7 ==&lt;br /&gt;
* [[Android_SDK|點我下載]]&lt;br /&gt;
* 執行效能優化。&lt;br /&gt;
* 優惠通知會顯示應用程式名稱。&lt;br /&gt;
* targetSDK 支援到24。&lt;br /&gt;
* 提升收廣告穩定性。&lt;br /&gt;
* support v4 需更新到 24 版以上。(其餘support lib 皆需升級到同一版本 如下例:)&lt;br /&gt;
 compile 'com.android.support:support-v4:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
 compile 'com.android.support:appcompat-v7:&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;24.2.0&amp;lt;/span&amp;gt;'&lt;br /&gt;
* 此版加入adid需使用google play service，如果dependencies沒有compile任何google play servers 時 (若已使用，需將版本提升至9.X.X)&lt;br /&gt;
需加入play-services-base 如下:&lt;br /&gt;
 compile 'com.google.android.gms:play-services-base:9.4.0'&lt;br /&gt;
&lt;br /&gt;
== v3.5.2 ==&lt;br /&gt;
&lt;br /&gt;
* targetSDK 支援到23。&lt;br /&gt;
* 執行效能優化，穩定性加強。&lt;br /&gt;
* support v4 需更新到 23 版以上。&lt;br /&gt;
* 使用AdMob 使用者需更新AdLocusAdapter.java。&lt;br /&gt;
* 使用inner class 報錯修復，須將程式碼 $ 字號部分換成 . 。&lt;br /&gt;
* Proguard 需加入以下反黃部分：&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keepattributes InnerClasses&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;-keep class **.R$* {&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;    &amp;lt;fields&amp;gt;;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;}&amp;lt;/span&amp;gt;&lt;br /&gt;
 -keep public class com.adlocus.** {*;}&lt;br /&gt;
 -keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{&amp;lt;methods&amp;gt;;}&lt;br /&gt;
&lt;br /&gt;
=== Eclipse ===&lt;br /&gt;
* AndroidManifest 的 application 中需加入provider 如下，並將 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt; 替換成 package name:&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;${applicationId}&amp;lt;/span&amp;gt;.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
以 package name 為 com.adlocus.example 的範例如下：&lt;br /&gt;
        &amp;lt;provider&lt;br /&gt;
            android:name=&amp;quot;com.adlocus.util.MultiProcessPreferences&amp;quot;&lt;br /&gt;
            android:authorities=&amp;quot;com.adlocus.example.ADLOCUS_CONTENT&amp;quot;&lt;br /&gt;
            android:exported=&amp;quot;false&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.4.2 ==&lt;br /&gt;
* 修正 Android 5.0 以上鎖屏點擊無效問題.&lt;br /&gt;
* 多項優化項目&lt;br /&gt;
===Android Studio===&lt;br /&gt;
* 使用 Gradle 權限簡化，只需在 AndroidManifest 中加入下面一行即可，舊版權限皆可移除。&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-sdk android:targetSdkVersion=&amp;quot;23&amp;quot; android:minSdkVersion=&amp;quot;9&amp;quot;&lt;br /&gt;
    tools:overrideLibrary=&amp;quot;com.adlocus.AdLocusLib&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Eclipse===&lt;br /&gt;
* Library project 更新：請移除AdLocusLib 後加入3.4.2版library project。&lt;br /&gt;
* AndroidManifest 的 application 中需加入AdActivity：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;activity android:name=&amp;quot;com.adlocus.AdActivity&amp;quot;&lt;br /&gt;
    android:theme=&amp;quot;@style/AdLocusDialogTheme&amp;quot;&lt;br /&gt;
    android:launchMode=&amp;quot;singleTask&amp;quot;&lt;br /&gt;
    android:excludeFromRecents=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/activity&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.21 ==&lt;br /&gt;
* 修正低於 Android 5.0 上會崩潰的問題.&lt;br /&gt;
&lt;br /&gt;
== v3.3.16 ==&lt;br /&gt;
* 修正當 Target SDK 大於等於 Lolipop 時的ICON白圖, 底圖顏色問題.&lt;br /&gt;
* 修正無法清除過期DB問題&lt;br /&gt;
* 增加 InterstitialVideo 的 onNofill 與 onClose 監聽事件.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
private InterstitialVideoReq mInterstitialVideoReq;&lt;br /&gt;
&lt;br /&gt;
@Override&lt;br /&gt;
protected void onCreate(Bundle savedInstanceState) {&lt;br /&gt;
    super.onCreate(savedInstanceState);&lt;br /&gt;
    &lt;br /&gt;
    mInterstitialVideoReq = new InterstitialVideoReq(this, KEY, new VideoAdListener() {&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onStart() {&lt;br /&gt;
            //we will start an activity and rotate screen to landscape,&lt;br /&gt;
            //make sure your code and your user are ready for a movie show!&lt;br /&gt;
            mInterstitialVideoReq.show();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onNofill() {&lt;br /&gt;
            // 沒有廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
        }&lt;br /&gt;
&lt;br /&gt;
        @Override&lt;br /&gt;
        public void onClose() {&lt;br /&gt;
            // 使用者關閉廣告&lt;br /&gt;
            mInterstitialVideoReq.removeListener();&lt;br /&gt;
&lt;br /&gt;
        }&lt;br /&gt;
    });&lt;br /&gt;
&lt;br /&gt;
    mInterstitialVideoReq.load();&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
//透過 mInterstitialVideoReq 與 onActivityResult()實做監聽影音廣告結束事件&lt;br /&gt;
@Override&lt;br /&gt;
protected void onActivityResult(int requestCode, int resultCode, Intent data)&lt;br /&gt;
{&lt;br /&gt;
    if(requestCode == 7522335)&lt;br /&gt;
        mInterstitialVideoReq.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
&lt;br /&gt;
    super.onActivityResult(requestCode, resultCode, data);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 增加 Admob 對 Interstitial 的 onClose 事件支援.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== v3.3.7 ==&lt;br /&gt;
* 修正在 Android 5.0 權限衝突的問題。&lt;br /&gt;
&lt;br /&gt;
更新至3.3.7需修改項目：&lt;br /&gt;
&lt;br /&gt;
1. 需將專案設定為 API Level 21 (5.0.1) 以上：&lt;br /&gt;
&lt;br /&gt;
eclipse 設定：專案上按右鍵 -&amp;gt; Properties -&amp;gt; Android -&amp;gt; Project Build Target -&amp;gt; 勾選API Level 21 以上 -&amp;gt; Apply -&amp;gt; OK&lt;br /&gt;
&lt;br /&gt;
2. 在 AndroidManifest 中移除以下三行權限：&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;uses-permission android:name=&amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;&amp;lt;permission android:name = &amp;quot;com.adlocus.permission.SEND&amp;quot; /&amp;gt;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
 &amp;lt;receiver &lt;br /&gt;
 	android:enabled=&amp;quot;true&amp;quot; &lt;br /&gt;
         android:process=&amp;quot;:adlocus&amp;quot;&lt;br /&gt;
 	android:name=&amp;quot;com.adlocus.push.PushReceive&amp;quot;&lt;br /&gt;
 	&amp;lt;span style=&amp;quot;color:#000000; background-color:#FFFF00&amp;quot;&amp;gt;&amp;lt;s&amp;gt;android:permission=&amp;quot;com.adlocus.permission.SEND&amp;quot;&amp;lt;/s&amp;gt;&amp;lt;/span&amp;gt;&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;android.intent.action.BOOT_COMPLETED&amp;quot; /&amp;gt;&lt;br /&gt;
 		&amp;lt;category android:name=&amp;quot;android.intent.category.DEFAULT&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 	&amp;lt;intent-filter&amp;gt;&lt;br /&gt;
 		&amp;lt;action android:name=&amp;quot;com.adlocus.action.RECEIVE&amp;quot; /&amp;gt;&lt;br /&gt;
 	&amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
 &amp;lt;/receiver&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== v3.3.6 ==&lt;br /&gt;
* 支援線上切換優惠訊息格式&lt;br /&gt;
&lt;br /&gt;
== v3.3.3 ==&lt;br /&gt;
* 新增[[Android_Video|全屏影音廣告]]&lt;br /&gt;
* 修復背景崩潰問題&lt;br /&gt;
* 修復初始化 InApp Ad 時, 未執行Listener 問題&lt;br /&gt;
* 修復全屏靜態廣告崩潰問題&lt;br /&gt;
&lt;br /&gt;
== v3.3.0 ==&lt;br /&gt;
* 新形態推播服務, 支援使用者自訂開關.&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Main_Page</id>
		<title>Main Page</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Main_Page"/>
				<updated>2022-05-12T07:16:23Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* Release Note News */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
這是由 AdLocus 提供的開發者 Wiki, 在這裡您可以即時取得 AdLocus 的最新 SDK, 文件, 與使用範例。&lt;br /&gt;
	&lt;br /&gt;
[https://wiki.adlocus.com/images/f/f8/200417_AdLocus_3rdPartyAPP.pdf AdLocus AdLocus第三方介紹簡報]&lt;br /&gt;
&lt;br /&gt;
若您有整合上的問題，以下是我們的聯絡資訊，我們期待您。&lt;br /&gt;
&lt;br /&gt;
* 行動廣告業務與市場及媒體合作&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: sales@adlocus.com&lt;br /&gt;
&lt;br /&gt;
* 開發者諮詢與技術服務諮詢&lt;br /&gt;
** Phone: +886-2-25172323&lt;br /&gt;
** Email: support@adlocus.com&lt;br /&gt;
&lt;br /&gt;
== Release Note News==&lt;br /&gt;
* 2022/05/12 AdLocus Android SDK 4.1.37 釋出&lt;br /&gt;
* 2021/12/28 AdLocus Android SDK 4.1.22 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.21 釋出&lt;br /&gt;
* 2021/08/05 AdLocus Android SDK 4.1.19 釋出&lt;br /&gt;
* 2021/07/16 AdLocus Android SDK 4.1.17 釋出&lt;br /&gt;
* 2021/06/17 AdLocus Android SDK 4.1.15 釋出&lt;br /&gt;
* 2021/05/11 AdLocus Android SDK 4.1.14 釋出&lt;br /&gt;
* 2020/08/30 AdLocus Android SDK 4.1.09 釋出&lt;br /&gt;
* 2020/06/30 AdLocus iOS SDK 5.2.0 釋出&lt;br /&gt;
* 2019/11/28 AdLocus Android SDK 4.1.07 釋出 &lt;br /&gt;
* 2016/11/10 AdLocus Android SDK 3.5.7 釋出&lt;br /&gt;
* 2016/06/2 AdLocus iOS SDK 4.1.1(Beta) 釋出&lt;br /&gt;
* 2016/02/25 AdLocus Android SDK 3.5.2 釋出&lt;br /&gt;
* 2016/01/19 AdLocus Android SDK 3.4.2 釋出&lt;br /&gt;
* 2015/07/15 AdLocus Android SDK 3.3.21 釋出&lt;br /&gt;
* 2015/07/08 AdLocus Android SDK 3.3.16 釋出&lt;br /&gt;
* 2015/02/25 AdLocus Android SDK 3.3.7 釋出&lt;br /&gt;
&lt;br /&gt;
== Changelog Note Link==&lt;br /&gt;
* [[iOS_Changelog|iOS_SDK 更新內容匯總]]&lt;br /&gt;
* [[Android_Changelog|And_SDK 更新內容匯總]]&lt;br /&gt;
&lt;br /&gt;
== 使用說明與SDK載點 ==&lt;br /&gt;
* [[Android_SDK|歡迎使用 Android SDK]] &lt;br /&gt;
* [[iOS_SDK|歡迎使用 iOS SDK]]&lt;br /&gt;
* [[Web_SDK|歡迎使用 Web SDK]]&lt;br /&gt;
&lt;br /&gt;
== 開發者Q&amp;amp;A ==&lt;br /&gt;
* [[estimate_income|收入試算]]&lt;br /&gt;
* [[settlement_tax|出帳與稅務]]&lt;br /&gt;
&lt;br /&gt;
== 特定區域主動推播體驗 ==&lt;br /&gt;
&lt;br /&gt;
iOS 文字推播&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://report.adlocus.com/background_fetch_demo.mov&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
InApp展示&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/2/2d/In_app.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;https://wiki.adlocus.com/images/4/4e/%E5%85%A8%E5%B1%8F.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
全屏影音&lt;br /&gt;
  &amp;lt;html5media height=&amp;quot;400&amp;quot;&amp;gt;File:SCR_20141006_141437.mp4&amp;lt;/html5media&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[register_auth|註冊＆審核]] ===&lt;br /&gt;
=== [[back_panel|後台使用]] ===&lt;br /&gt;
=== [[advertisement_profit|支援廣告類型]] ===&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!-- === [[document|文件]] === --&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
=== [[trick|技巧]] (區域性判斷/使用特定廣告平台/推播服務提示對話框) === &lt;br /&gt;
 格式語法參考：&lt;br /&gt;
=== [[error_code|錯誤碼]] ===&lt;br /&gt;
&lt;br /&gt;
http://zh.wikipedia.org/wiki/Wikipedia:%E6%96%B0%E6%89%8B%E5%85%A5%E9%96%80/%E7%B6%AD%E5%9F%BA%E6%96%87%E6%9C%AC &lt;br /&gt;
http://zh.wikipedia.org/wiki/User:Auvaand/%E7%BB%B4%E5%9F%BA%E8%AF%AD%E6%B3%95&lt;br /&gt;
--&amp;gt;&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	<entry>
		<id>https://wiki.adlocus.com/index.php?title=Android_SDK_Setting</id>
		<title>Android SDK Setting</title>
		<link rel="alternate" type="text/html" href="https://wiki.adlocus.com/index.php?title=Android_SDK_Setting"/>
				<updated>2022-05-12T07:15:37Z</updated>
		
		<summary type="html">&lt;p&gt;Leo wu: /* 環境設置 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
= Getting Start with AdLocus =&lt;br /&gt;
* 以下將說明您怎麼整入 AdLocus SDK.&lt;br /&gt;
* FCM Github link: https://github.com/vfhhu/AdLocusSample&lt;br /&gt;
&lt;br /&gt;
==環境設置==&lt;br /&gt;
* Min SDK : 19&lt;br /&gt;
* Compile Sdk Version : 31&lt;br /&gt;
&lt;br /&gt;
==Project build.gradle==&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
buildscript {&lt;br /&gt;
   repositories {&lt;br /&gt;
       google()&lt;br /&gt;
       mavenCentral()&lt;br /&gt;
       jcenter()&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Dependency lib==&lt;br /&gt;
=== Hyxen SDK ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//implementation(name: 'adlocusaar-debug', ext: 'aar')&lt;br /&gt;
implementation ('io.github.vfhhu:adlocusaar:4.1.37')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 系統 ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'com.android.support:appcompat-v7:26.1.0'&lt;br /&gt;
testImplementation 'junit:junit:4.12'&lt;br /&gt;
androidTestImplementation 'com.android.support.test:runner:1.0.2'&lt;br /&gt;
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Security ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Security&lt;br /&gt;
implementation &amp;quot;androidx.security:security-crypto:1.1.0-alpha02&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &lt;br /&gt;
=== Json parser ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Json parser&lt;br /&gt;
annotationProcessor 'com.bluelinelabs:logansquare-compiler:1.3.6'&lt;br /&gt;
implementation 'com.bluelinelabs:logansquare:1.3.7'&lt;br /&gt;
implementation &amp;quot;com.github.aurae.retrofit2:converter-logansquare:1.4.1&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Http agent ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// Http agent&lt;br /&gt;
implementation 'com.squareup.retrofit2:retrofit:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== RxJava ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxjava:2.0.6'&lt;br /&gt;
implementation 'io.reactivex.rxjava2:rxandroid:2.0.1'&lt;br /&gt;
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Google ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
// 如果有用到 Google Ads 請使用以下版本&lt;br /&gt;
implementation 'com.google.android.gms:play-services-ads:15.0.1'&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Init SDK設置 ==&lt;br /&gt;
* App First Activity&lt;br /&gt;
* FCM APP key&lt;br /&gt;
* 在AD Locus後台的App key&lt;br /&gt;
* 在Application嘗試取得FCM token，init SDK：&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
//Init new AdLocus SDK&lt;br /&gt;
private void initAdlocus(){&lt;br /&gt;
    FirebaseApp.initializeApp(this);&lt;br /&gt;
    String token = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
    if(BuildConfig.DEBUG){&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , {your fcm app key},getPackageName(), {your hynex app key});&lt;br /&gt;
    }else{&lt;br /&gt;
        AdLocus.getInstance(this).checkUserStatement&lt;br /&gt;
         (token , ‘pass’,getPackageName(), {your hynex app key});&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Example：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED&lt;br /&gt;
       &amp;amp;&amp;amp; ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
   &lt;br /&gt;
   initAdlocus();&lt;br /&gt;
} else {&lt;br /&gt;
   ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, TAG_LOCATION);&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Permission result(不管是否允許permission，都需要init new SDK)&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
@Override&lt;br /&gt;
public void onRequestPermissionsResult(int requestCode,&lt;br /&gt;
                                      String permissions[], int[] grantResults) {&lt;br /&gt;
   switch (requestCode) {&lt;br /&gt;
       case TAG_LOCATION: {&lt;br /&gt;
           // If request is cancelled, the result arrays are empty.&lt;br /&gt;
           if (grantResults.length &amp;gt; 0 &amp;amp;&amp;amp; grantResults[0] == PackageManager.PERMISSION_GRANTED) {&lt;br /&gt;
           } else {&lt;br /&gt;
           }&lt;br /&gt;
           initAdlocus();&lt;br /&gt;
           return;&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Token receiver：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseInstanceIDService extends FirebaseInstanceIdService {&lt;br /&gt;
   private final static String TAG = MyFirebaseInstanceIDService.class.getSimpleName();&lt;br /&gt;
&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onTokenRefresh() {&lt;br /&gt;
       // Get updated InstanceID token.&lt;br /&gt;
       String refreshedToken = FirebaseInstanceId.getInstance().getToken();&lt;br /&gt;
       Logger.d(TAG, &amp;quot;Refreshed token: &amp;quot; + refreshedToken);&lt;br /&gt;
&lt;br /&gt;
       // If you want to send messages to this application instance or&lt;br /&gt;
       // manage this apps subscriptions on the server side, send the&lt;br /&gt;
       // Instance ID token to your app server.&lt;br /&gt;
       sendRegistrationToServer(refreshedToken);&lt;br /&gt;
   }&lt;br /&gt;
   // [END refresh_token]&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Persist token to third-party servers.&lt;br /&gt;
    * &amp;lt;p&amp;gt;&lt;br /&gt;
    * Modify this method to associate the user's FCM InstanceID token with any server-side account&lt;br /&gt;
    * maintained by your application.&lt;br /&gt;
    *&lt;br /&gt;
    * @param token The new token.&lt;br /&gt;
    */&lt;br /&gt;
   private void sendRegistrationToServer(String token) {&lt;br /&gt;
       AdLocus.getInstance().updatePushToken(token);&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 建立FCM Message receiver&lt;br /&gt;
* 將收到GetFCMDataResponse.TAG_TARGET的Key若mapping到Constants.TAG_FCM_TARGET則callAdLocus.getInstance().sendFCMMessage(this,data)將FCM傳入SDK&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
public class MyFirebaseMessagingService extends FirebaseMessagingService {&lt;br /&gt;
&lt;br /&gt;
   private static final String TAG = &amp;quot;MyFirebaseMsgService&amp;quot;;&lt;br /&gt;
&lt;br /&gt;
   /**&lt;br /&gt;
    * Called when message is received.&lt;br /&gt;
    *&lt;br /&gt;
    * @param remoteMessage Object representing the message received from Firebase Cloud Messaging.&lt;br /&gt;
    */&lt;br /&gt;
   // [START receive_message]&lt;br /&gt;
   @Override&lt;br /&gt;
   public void onMessageReceived(RemoteMessage remoteMessage) {&lt;br /&gt;
       Logger.d(TAG, &amp;quot;From: &amp;quot; + remoteMessage.getFrom());&lt;br /&gt;
&lt;br /&gt;
       // Check if message contains a data payload.&lt;br /&gt;
       if (remoteMessage.getData().size() &amp;gt; 0) {&lt;br /&gt;
           Map&amp;lt;String, String&amp;gt; data = remoteMessage.getData();&lt;br /&gt;
           Logger.d(TAG, &amp;quot;Message data payload: &amp;quot; + remoteMessage.getData());&lt;br /&gt;
           if (TextUtils.equals(data.get(GetFCMDataResponse.TAG_TARGET), Constants.TAG_FCM_TARGET))&lt;br /&gt;
               AdLocus.getInstance().sendFCMMessage(this,data);&lt;br /&gt;
           if (/* Check if data needs to be processed by long running job */ true) {&lt;br /&gt;
               // For long-running tasks (10 seconds or more) use Firebase Job Dispatcher.&lt;br /&gt;
//                scheduleJob();&lt;br /&gt;
           } else {&lt;br /&gt;
               // Handle message within 10 seconds&lt;br /&gt;
//                handleNow();&lt;br /&gt;
           }&lt;br /&gt;
       }&lt;br /&gt;
   }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* 在manifests將FCM message reveiver與FCM token receiver import：&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;!-- FCM --&amp;gt;&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseInstanceIDService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.INSTANCE_ID_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;service android:name=&amp;quot;.MyFirebaseMessagingService&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;intent-filter&amp;gt;&lt;br /&gt;
       &amp;lt;action android:name=&amp;quot;com.google.firebase.MESSAGING_EVENT&amp;quot; /&amp;gt;&lt;br /&gt;
   &amp;lt;/intent-filter&amp;gt;&lt;br /&gt;
&amp;lt;/service&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 備註 ==&lt;br /&gt;
* 如有使用混淆程式碼,必須在 proguard-android.txt 加入&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
 keep class com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep interface com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 keep enum com.hyxen.adlocusaar.** {*;}&lt;br /&gt;
 dontwarn com.squareup.okhttp3.**&lt;br /&gt;
 keep class com.squareup.okhttp3.** { *;}&lt;br /&gt;
 dontwarn okio.**&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* FCM官方教學網頁：https://firebase.google.com/docs/cloud-messaging/android/client&lt;br /&gt;
* android 11(API 30)之後須加入權限 READ_PHONE_STATE&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;java&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;uses-permission android:name=&amp;quot;android.permission.READ_PHONE_STATE&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
* fcm key只需要在debug模式送出&lt;br /&gt;
* release送出fcm key可能會有洩漏風險&lt;br /&gt;
* 所以只需輸入pass字串&lt;br /&gt;
* 注意1:必須至少執行一次debug模式且帶入fcm key&lt;br /&gt;
* 注意2:BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* BuildConfig 須注意別 import 到其他 Module 的 BuildConfig&lt;br /&gt;
* 特別注意,如有app使用 4.1.36 以前的版本,且曾經被play下架或是拒絕過&lt;br /&gt;
必須使用4.1.36版及之後或是沒問題的版本並發布到play所有測試及正式區&lt;br /&gt;
並設定成100%發布,用以覆蓋所有有問題的版本&lt;/div&gt;</summary>
		<author><name>Leo wu</name></author>	</entry>

	</feed>