⚠️ 近期所有提交均为AI开发及修改！
本项目已全面适配最新 Android SDK 34 (Android 14)，并迁移到 AndroidX 支持库。
- minSdk: 21 (Android 5.0)
- compileSdk: 34 (Android 14)
- targetSdk: 34
- Java: 8 或更高版本
- Gradle: 6.7.1
- Android Gradle Plugin: 4.2.2
在项目的根目录 build.gradle 里的 allprojects 下添加：
allprojects {
repositories {
google()
mavenCentral()
}
}在 app 目录的 build.gradle 下添加依赖：
dependencies {
implementation 'com.zhangym:verificationcodeview:2.0.0'
}将 library 模块作为子模块导入你的项目：
dependencies {
implementation project(':library')
}下载项目，将 library/src/main/java/com/zhangym/customview/VerificationCodeView.java 和 res/values/attrs.xml 文件拷贝进你的项目。
在布局中集成，注意需要在布局的根节点添加命名空间：
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent">
<com.zhangym.customview.VerificationCodeView
android:id="@+id/verificationCodeView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:padding="20dp"
app:interferenceCirclesCount="40"
app:interferenceCirclesRadius="5"
app:interferenceLinesCount="10"
app:isShowInterferenceCircles="true"
app:isShowInterferenceLines="true"
app:isTextBold="true"
app:textSize="50sp"
app:textSkewX="0"
app:verificationText="9D27" />
</LinearLayout>| 属性名 | 类型 | 说明 | 默认值 |
|---|---|---|---|
verificationText |
string | 验证码文本 | - |
textColor |
color | 验证码文本颜色 | #000000（黑色） |
textSize |
dimension | 验证码文本尺寸 | 16sp |
isUnderLine |
boolean | 是否显示下划线 | false |
isTextBold |
boolean | 字体是否为粗体 | false |
textSkewX |
float | 文本倾斜度（正数左斜，负数右斜） | 0 |
strokeWidth |
float | 文字描边宽度 | 0 |
isShowInterferenceLines |
boolean | 是否显示干扰线条 | true |
interferenceLinesCount |
integer | 干扰线条数量 | 10 |
interferenceLinesColor |
color | 干扰线条颜色（不设置则随机） | 随机 |
interferenceLinesWidth |
float | 干扰线条宽度 | 3 |
isShowInterferenceCircles |
boolean | 是否显示干扰圆点 | true |
interferenceCirclesCount |
integer | 干扰圆点数量 | 100 |
interferenceCirclesColor |
color | 干扰圆点颜色（不设置则随机） | 随机 |
interferenceCirclesRadius |
float | 干扰圆点半径 | 5 |
verificationCodeBackground |
color | 验证码背景色 | #808080（灰色） |
| 方法 | 说明 |
|---|---|
setVerificationText(String text) |
设置验证码文本内容 |
setTextColor(int color) |
设置文本颜色 |
setTextSize(int size) |
设置文本大小 |
setTextBold(boolean bold) |
设置文本是否加粗 |
setUnderLine(boolean underline) |
设置是否显示下划线 |
setTextSkewX(float skewX) |
设置文本倾斜度 |
setStrokeWidth(float width) |
设置文字描边宽度 |
setShowInterferenceLines(boolean show) |
设置是否显示干扰线条 |
setInterferenceLinesCount(int count) |
设置干扰线条数量 |
setInterferenceLinesColor(int color) |
设置干扰线条颜色（设置后不再随机） |
setInterferenceLinesWidth(float width) |
设置干扰线条宽度 |
setLineColorRandom(boolean random) |
设置线条颜色是否随机 |
setShowInterferenceCircles(boolean show) |
设置是否显示干扰圆点 |
setInterferenceCirclesCount(int count) |
设置干扰圆点数量 |
setInterferenceCirclesColor(int color) |
设置干扰圆点颜色（设置后不再随机） |
setInterferenceCirclesRadius(float radius) |
设置干扰圆点半径 |
setCircleColorRandom(boolean random) |
设置圆点颜色是否随机 |
setVerificationCodeBackground(int color) |
设置验证码背景色 |
| 方法 | 说明 |
|---|---|
getVerificationText() |
获取当前验证码文本 |
isShowInterferenceLines() |
是否显示干扰线条 |
isShowInterferenceCircles() |
是否显示干扰圆点 |
isTextBold() |
文本是否为粗体 |
isUnderLine() |
是否显示下划线 |
isLineColorRandom() |
线条颜色是否随机 |
isCircleColorRandom() |
圆点颜色是否随机 |
getInterferenceLinesCount() |
获取干扰线条数量 |
getInterferenceLinesWidth() |
获取干扰线条宽度 |
getInterferenceCirclesCount() |
获取干扰圆点数量 |
getInterferenceCirclesRadius() |
获取干扰圆点半径 |
getTextColor() |
获取文本颜色 |
getTextSize() |
获取文本大小 |
getTextSkewX() |
获取文本倾斜度 |
getStrokeWidth() |
获取文字描边宽度 |
getVerificationCodeBackground() |
获取背景色 |
import com.zhangym.customview.VerificationCodeView;
public class MainActivity extends AppCompatActivity {
private VerificationCodeView mCodeView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mCodeView = findViewById(R.id.verificationCodeView);
// 设置验证码文本
mCodeView.setVerificationText("ABCD");
// 设置文本样式
mCodeView.setTextColor(Color.BLUE);
mCodeView.setTextBold(true);
mCodeView.setTextSize(40);
mCodeView.setTextSkewX(0.3f); // 左倾斜
// 设置干扰效果
mCodeView.setInterferenceLinesCount(15);
mCodeView.setInterferenceCirclesCount(150);
mCodeView.setCircleColorRandom(true);
mCodeView.setLineColorRandom(true);
// 点击刷新验证码
mCodeView.setOnClickListener(v -> {
Random random = new Random();
String code = String.valueOf(random.nextInt(10)) +
random.nextInt(10) +
random.nextInt(10) +
random.nextInt(10);
mCodeView.setVerificationText(code);
});
}
}
- Android 5.0 (API 21) 及以上版本
- 完全支持 AndroidX
- 支持深色模式
- 支持 RTL 布局（从右到左）
- 适配 Android SDK 34 (Android 14)
- 迁移到 AndroidX
- 升级 Gradle 到 8.2.0
- 更新所有依赖到最新稳定版本
- 初始版本
- 支持 SDK 25
Copyright 2017-2024 Zhang Yongming
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.