Skip to content

Latest commit

 

History

History
388 lines (306 loc) · 15.5 KB

SecondaryDevelopmentResourceReplaceTutorial.md

File metadata and controls

388 lines (306 loc) · 15.5 KB

2018年07月17日18:03:50

二次开发三方与素材替换说明文档

目录

包名应用签名替换

  1. 包名修改 ,在项目路径下config.gradle文件中把 com.zhiyicx.thinksnsplus 修改自己的包名名称(路径地址:thinksns-system-android\config.gradle )。

    1. 必须提供自己的包名名称。
    2. 包名规则:采用反写域名命名规则,即 com.xx.xxx.xxxx 形式,全部使用小写字母。一级包名为com,二级包名为xx(一般为公司或个人域名),三级包名根据应用进行命名,四级包名为功能模块名。如:com.tencent.qq.activitys ,这样具备较高可读性,一看就知道是腾讯公司QQ软件中存放activity的包。

    config_capture

  2. 签名文件分为调试版和正式发布版,生成自己的签名文件后替换图中所示文件(注: 必须提供自己的签名文件和对应的别名以及密码)查看创建签名文档

    signature_show

  3. 配置编译时签名,app/build.gradle

   apply plugin: 'com.android.application'

   ...
   android {
     ...
     signingConfigs {
          release {
               storeFile file('../thinksnsplus.jks')
               storePassword '........'
               keyAlias 'thinksnsplus'
               keyPassword '.........'
       }
          debug {
               storeFile file('../thinksnsplus.jks')
               storePassword '.........'
               keyAlias 'thinksnsplus'
               keyPassword '.........'
       }
   }
   ...

第三方账号配置

项目使用中的三方账号包括:友盟、新浪微博、微信、QQ、极光推送、高德地图、支付宝支付。请在相应平台申请后修改配置文件,三方申请注册需要的资料请查看移动端打包上线需要得资料说明

  1. 友盟(Umeng)配置 ,修改友盟 UMENG_APPKEY,位于 baseproject/build.gradle

    apply plugin: 'com.android.library'
    android {
    ...
    
            // 友盟三方key配置
            manifestPlaceholders = [
                    ...
                    UMENG_APPKEY: "58d0998e9f06fd05680011f6",
                    ...
            ]
    
        }
    ...
    
    
  2. 高德地图配置 ,修改高德 AMAP_APPKEY,位于 baseproject/build.gradle

    apply plugin: 'com.android.library'
    android {
    ...
    
    
            manifestPlaceholders = [
                    ...
                    AMAP_APPKEY: "e954e82021efe2f4d334879cff3880cf", // 高德三方配置
    
            ]
    
        }
    ...
    
    
  3. 极光推送配置,位于 app/build.gradle, 极光推送回调请查看 app/src/main/java/jpush

    apply plugin: 'com.android.library'
    android {
    ...
    
            // 极光推送
                 manifestPlaceholders = [
                         JPUSH_PKGNAME: applicationId,
                         JPUSH_APPKEY : "85f8e1049e913108b9d9bc67", //JPush上注册的包名对应的appkey.
                         JPUSH_CHANNEL: "developer-default", //暂时填写默认值即可.
                 ]
    
        }
    ...
    
    
  4. QQ、Sina、Wixin 三方账号 key 配置。位于 baseproject/src/main/java/com.zhiyicx.baseproject/config/UmengConfig.class。 QQ 的 QQ_APPID 也需要在baseproject/build.gradle中配置

    package com.zhiyicx.baseproject.config;
    
    /**
     * @Describe 友盟三方帐号配置
     * @Author Jungle68
     * @Date 2016/12/21
     * @Contact master.jungle68@gmail.com
     */
    
    public class UmengConfig {
        // QQ
        public static String QQ_APPID = "1105978541";
        public static String QQ_SECRETKEY = "Q47tAluWzkd0v4Rp";
        // 微信
        public static String WEIXIN_APPID = "wx970d230ad5ab3b23";
        public static String WEIXIN_SECRETKEY = "b2a61add26e0ef3c4bf24ac9387a02d2";
        // 新浪
        public static String SINA_APPID = "732480598";
        public static String SINA_SECRETKEY = "51c1d72c618224a469531d39fa313ec7";
        public static String SINA_RESULT_RUL="https://sns.whalecloud.com/sina2/callback";
    }
    
    
    
    apply plugin: 'com.android.library'
    android {
       buildTypes {
    ...
        // 三方 key
        manifestPlaceholders = [
                TECENT_APPID: 1105978541, // 腾讯 QQ id
    ...
        ]
    	}
    }
    
    

    注意: 分享和支付回掉需要根据您的包名来判断存放位置,例如:您的包名是 com.guduk.www,那么您需要在 app/main/java/ 创建自己的包名路径,并将 包wxapi 下的代码和WBShareActivity移动过去。

    share_packge_change

  5. 环信配置,修改环信 EASEMOB_APPKEY,位于 baseproject/build.gradle

    apply plugin: 'com.android.library'
    android {
    ...
           buildTypes {
        release {
            // 三方 key
            manifestPlaceholders = [
        				...
                    EASEMOB_APPKEY: "1139171207178196#thinksns-plus", // 环信三方配置正式打包版本
            ]
        }
        debug {
            // 三方 key
            manifestPlaceholders = [
     					...
                    EASEMOB_APPKEY: "1120180716146578#yunmeoshequ", // 环信三方配置测试版本
            ]
        }
    }
        }
    ...
    
    

服务器地址

系统版

  1. 服务器地址与接口地址都位置 baseproject/src/main/java/config/Apiconfig.class 中。修改 APP_DOMAIN_FORMAL 即可。
    public class ApiConfig {
       ...
        /**
         * 网络根地址  http://192.168.10.222/
         * 测试服务器:http://192.168.2.222:8080/mockjs/2/test-get-repose-head-normal?
         */

        //public static final String APP_DOMAIN = "http://192.168.2.222:8080/mockjs/2/";// rap 测试服务器

        public static final boolean APP_IS_NEED_SSH_CERTIFICATE = true;// 自定义证书时使用false
        //        public static final String APP_DOMAIN = "https://plus.medz.cn/";// 在线测试服务器 2
        public static final String APP_DOMAIN_DEV = "http://dev.zhibocloud.cn/";// 模拟在线正式服务器
        public static final String APP_DOMAIN_TEST = "http://test-plus.zhibocloud.cn/";// 在线测试服务器
        public static final String APP_DOMAIN_FORMAL = "https://tsplus.zhibocloud.cn/";// 正式服务器
        public static String APP_DOMAIN = APP_DOMAIN_FORMAL;

        public static final String URL_ABOUT_US = "api/" + API_VERSION_2 + "/aboutus";// 关于我们网站
        public static final String URL_JIPU_SHOP = "http://demo.jipukeji.com";// 极铺购物地址
        ...

直播版

  1. 同样需要和系统版一样配置APP_DOMAIN_FORMAL,同时还需要配置直播服务器地址,以及直播中用到的IM地址与端口;

  2. 直播域名与路径、版本号修改修改:zhibolibrary/src/main/java/com/zhiyicx/zhibolibrary/model/api/ZBLApi.java中进行修改

     // 直播服务器地址,更具自己的修改
        public static final String ZHIBO_BASE_URL = "http://zts.zhibocloud.cn";
     // 版本号,更具需要修改
        public static final String ZHIBO_BASE_VERSION = "1.0";
         // 应用服务器对接直播服务器的协议地址:更具需求修改
        public static String CONFIG_EXTRAL_URL = "api";
    
  3. IM地址与端口,位于oldimsdk/src/main/java/com/zhiyicx/old/imsdk/service/ImService.java

	private static final String WEB_SOCKET_PORT = "9902"; //端口修改
   private static final String WEB_SOCKET_HOST = "114.215.203.142"; // 地址修改

资源替换

1. APP图标替换,位于 app/src/main/res , icon.png

位置(icon.png) 大小(宽x高) 图标
mipmap-hdpi 72x72 icon_hdpi
mipmap-xhdpi 96x96 icon_xhdpi
mipmap-xxhdpi 144x144 icon_xxhdpi
mipmap-xxxhdpi 192x192 icon_xxxhdpi

2. 引导图替换, 位于 baseproject/src/main/res/ ,guide.png

位置(guide.png) 大小(宽x高) 图标
mipmap-hdpi 480x800
mipmap-xhdpi 720x1280
mipmap-xxhdpi 1080x1920 guide
mipmap-xxxhdpi 1440x2560

3. 广告底部 logo, 位于 app/src/main/res/ ,pic_adver_logo.png

位置(pic_adver_logo.png) 大小(宽x高) 图标
mipmap-hdpi 288x86 guide_logo_hdpi
mipmap-xhdpi 384x115 guide_logo_xhdpi
mipmap-xxhdpi 576x173 guide_logo_xxhdpi
mipmap-xxxhdpi 763x230 guide_logo_xxxhdpi

4. 、发布页 logo 图标替换, 位于 app/src/main/res/ ,logo_send_thinksns.png

位置(logo_send_thinksns.png) 大小(宽x高) 图标
mipmap-hdpi 450x450 logo_send_thinksns_hdpi
mipmap-xhdpi 600x600 logo_send_thinksns_xhdpi
mipmap-xxhdpi 900x900 logo_send_thinksns_xxhdpi
mipmap-xxxhdpi 1200x1200 logo_send_thinksns_xxxhdpi

5. 缺省信息图片替换, 位于 baseproject/src/main/res/ ,guide.png,此处以 xhdip文件下的说明,具体替换时,请同时替换hdpi、xhdpi、xxhdpi、xxxhdpi

名字 说明 图标
pic_default_man.png 默认头像,男 pic_default_man
pic_default_woman.png 默认头像,女 pic_default_woman
pic_default_secret.png 默认头像,保密 pic_default_secret
img_default_delete.png 默认删除缺省图 img_default_delete
img_default_internet.png 默认网络差缺省图 img_default_internet
img_default_nobody.png 默认没有用户缺省图 img_default_nobody
img_default_nothing.png 默认什么也没有缺省图 img_default_nothing
img_default_search.png 默认没有搜索到缺省图 img_default_search

6. 主页底部导航栏替换,位于 app/main/src/res/,,此处以 xhdip文件下的说明,具体替换时,请同时替换hdpi、xhdpi、xxhdpi、xxxhdpi

  • 首页底部导航背景色/app/src/main/res/values/colors.xml中的 <color name="home_bottom_navigate_bg">#363844</color>

  • 底部导航文字颜色/app/src/main/java/com/zhiyicx/thinksnsplus/modules/home/HomeFragment.java

        /**
     * 改变导航栏按钮的状态
     *
     * @param position 当前 viewpager 的位置
     */
    private void changeNavigationButton(int position) {
    		// 选中后的颜色 R.color.themeColor
        int checkedColor = ContextCompat.getColor(getContext(), R.color.themeColor);
          // 未选中的颜色
        int unckeckedColor = ContextCompat.getColor(getContext(), R.color.home_bottom_navigate_text_normal);
    }
    
名字 大小(宽x高) 说明 图标
common_ico_bottom_add.png 120x98 加号 common_ico_bottom_add
common_ico_bottom_discover_high.png 48x48 发现高亮 common_ico_bottom_discover_high
common_ico_bottom_discover_normal.png 48x48 发现常规 common_ico_bottom_discover_normal
common_ico_bottom_home_high.png 48x48 主页高亮 common_ico_bottom_home_high
common_ico_bottom_home_normal.png 48x48 主页常规 common_ico_bottom_home_normal
common_ico_bottom_me_high.png 48x48 我的高亮 common_ico_bottom_me_high
common_ico_bottom_me_normal.png 48x48 我的常规 common_ico_bottom_me_normal
common_ico_bottom_me_remind.png 48x48 我的带小红点 common_ico_bottom_me_remind
common_ico_bottom_message_high.png 48x48 消息高亮 common_ico_bottom_message_high
common_ico_bottom_message_normal.png 48x48 消息常规 common_ico_bottom_message_normal
common_ico_bottom_message_remind.png 48x48 消息带小红点 common_ico_bottom_message_remind

7. App 名字修改,位于 app/src/main/res/values/strings.xml,修改 app_name 即可。

<resources>
    <string name="app_name">ThinkSNS+</string>
    <string name="copyright">Powered by ThinkSNS ©2017 ZhishiSoft All Rights Reserced.</string>
    ...

8. 修改主体颜色、文字大小、间距等。

相关文件colors_tsp_style.xmldimens_tsp_font_size.xmldimens_tsp_spacing.xml位于baseproject/src/main/res/values下。

具体信息可以查看 视觉文档