Initial commit: Python Calculator for Android

Author: yuqi20000915

.github/workflows/build.yml

@@ -0,0 +1,26 @@
+name: Build Android APK
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Build with Buildozer
+      uses: ArtemSBulgakov/buildozer-action@v1
+      id: buildozer
+      with:
+        command: buildozer android debug
+        buildozer_version: stable
+
+    - name: Upload APK
+      uses: actions/upload-artifact@v3
+      with:
+        name: calculator-apk
+        path: bin/*.apk

.gitignore

@@ -0,0 +1,23 @@
+# Buildozer files
+.buildozer/
+bin/
+build/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

README.md

@@ -0,0 +1,73 @@
+# Python 计算器 Android APK
+
+这是一个使用 Python 和 Kivy 框架开发的计算器应用。
+
+## 功能特性
+
+- 基本算术运算：加、减、乘、除
+- 小数点支持
+- 清除功能
+- 简洁的用户界面
+
+## 本地测试
+
+1. 安装依赖：
+```bash
+pip install -r requirements.txt
+```
+
+2. 运行应用：
+```bash
+python main.py
+```
+
+## 打包成 Android APK
+
+### 方法一：使用 Buildozer（推荐在 Linux 上使用）
+
+1. 安装 Buildozer：
+```bash
+pip install buildozer
+```
+
+2. 安装必要的系统依赖（Ubuntu/Debian）：
+```bash
+sudo apt update
+sudo apt install -y git zip unzip openjdk-17-jdk python3-pip autoconf libtool pkg-config zlib1g-dev libncurses5-dev libncursesw5-dev libtinfo5 cmake libffi-dev libssl-dev
+```
+
+3. 初始化并构建 APK：
+```bash
+buildozer android debug
+```
+
+4. APK 文件将生成在 `bin/` 目录下
+
+### 方法二：使用 Python-for-Android
+
+```bash
+pip install python-for-android
+p4a apk --private . --package=org.example.calculator --name "Calculator" --version 1.0 --bootstrap=sdl2 --requirements=python3,kivy --permission INTERNET
+```
+
+### 方法三：使用在线服务
+
+如果你在 Windows 上开发，可以使用以下在线服务：
+- **Google Colab** + Buildozer
+- **GitHub Actions** 自动构建
+
+## 注意事项
+
+- Buildozer 在 Linux 或 macOS 上运行最佳
+- Windows 用户建议使用 WSL2（Windows Subsystem for Linux）
+- 首次构建会下载 Android SDK/NDK，需要较长时间和稳定的网络连接
+- 确保有足够的磁盘空间（至少 10GB）
+
+## 应用截图
+
+计算器包含以下功能按钮：
+- 数字键：0-9
+- 运算符：+、-、*、/
+- 小数点：.
+- 清除：C
+- 等于：=

build_docker.bat

@@ -0,0 +1,11 @@
+@echo off
+echo 正在安装 python-for-android...
+pip install python-for-android
+
+echo.
+echo 开始构建 APK...
+p4a apk --private . --package=org.example.calculator --name "Calculator" --version 1.0 --bootstrap=sdl2 --requirements=python3,kivy --permission INTERNET --arch=armeabi-v7a
+
+echo.
+echo 构建完成！APK 文件在当前目录下
+pause

build_windows.bat

@@ -0,0 +1,24 @@
+[app]
+title = Calculator
+package.name = calculator
+package.domain = org.example
+
+source.dir = .
+source.include_exts = py,png,jpg,kv,atlas
+
+version = 1.0
+
+requirements = python3,kivy
+
+orientation = portrait
+fullscreen = 0
+
+android.permissions = 
+android.api = 31
+android.minapi = 21
+android.ndk = 25b
+android.accept_sdk_license = True
+
+[buildozer]
+log_level = 2
+warn_on_root = 1

buildozer.spec

@@ -0,0 +1,77 @@
+from kivy.app import App
+from kivy.uix.boxlayout import BoxLayout
+from kivy.uix.button import Button
+from kivy.uix.textinput import TextInput
+
+
+class CalculatorApp(App):
+    def build(self):
+        self.operators = ['+', '-', '*', '/']
+        self.last_was_operator = None
+        self.last_button = None
+        
+        main_layout = BoxLayout(orientation='vertical')
+        self.solution = TextInput(
+            multiline=False, readonly=True, halign='right',
+            font_size=55, size_hint=(1, 0.2)
+        )
+        main_layout.add_widget(self.solution)
+        
+        buttons = [
+            ['7', '8', '9', '/'],
+            ['4', '5', '6', '*'],
+            ['1', '2', '3', '-'],
+            ['.', '0', 'C', '+'],
+        ]
+        
+        for row in buttons:
+            h_layout = BoxLayout()
+            for label in row:
+                button = Button(
+                    text=label,
+                    pos_hint={'center_x': 0.5, 'center_y': 0.5},
+                    font_size=32
+                )
+                button.bind(on_press=self.on_button_press)
+                h_layout.add_widget(button)
+            main_layout.add_widget(h_layout)
+        
+        equals_button = Button(
+            text='=', pos_hint={'center_x': 0.5, 'center_y': 0.5},
+            font_size=32
+        )
+        equals_button.bind(on_press=self.on_solution)
+        main_layout.add_widget(equals_button)
+        
+        return main_layout
+    
+    def on_button_press(self, instance):
+        current = self.solution.text
+        button_text = instance.text
+        
+        if button_text == 'C':
+            self.solution.text = ''
+        else:
+            if current and (
+                self.last_was_operator and button_text in self.operators):
+                return
+            elif current == '' and button_text in self.operators:
+                return
+            else:
+                new_text = current + button_text
+                self.solution.text = new_text
+        self.last_button = button_text
+        self.last_was_operator = self.last_button in self.operators
+    
+    def on_solution(self, instance):
+        text = self.solution.text
+        if text:
+            try:
+                solution = str(eval(self.solution.text))
+                self.solution.text = solution
+            except Exception:
+                self.solution.text = 'Error'
+
+
+if __name__ == '__main__':
+    CalculatorApp().run()

main.py

@@ -0,0 +1 @@
+kivy==2.3.0

requirements.txt

@@ -0,0 +1,28 @@
+@echo off
+echo ========================================
+echo Python 计算器 - Windows 环境配置
+echo ========================================
+echo.
+
+echo 步骤 1: 安装 Python 依赖
+pip install kivy python-for-android
+
+echo.
+echo 步骤 2: 需要安装的额外工具
+echo.
+echo 请确保已安装以下工具：
+echo 1. Java JDK 8 或更高版本
+echo    下载地址: https://www.oracle.com/java/technologies/downloads/
+echo.
+echo 2. Android SDK（可通过 Android Studio 安装）
+echo    下载地址: https://developer.android.com/studio
+echo.
+echo 3. 设置环境变量：
+echo    JAVA_HOME = JDK 安装路径
+echo    ANDROID_HOME = Android SDK 路径
+echo    PATH 中添加: %%ANDROID_HOME%%\tools 和 %%ANDROID_HOME%%\platform-tools
+echo.
+echo ========================================
+echo 配置完成后，运行 build_windows.bat 构建 APK
+echo ========================================
+pause

setup_windows.bat

@@ -0,0 +1,69 @@
+# 使用 GitHub Actions 构建 Android APK
+
+## 步骤 1：创建 GitHub 仓库
+
+1. 访问 https://github.com/new
+2. 输入仓库名称，例如：`python-calculator-android`
+3. 选择 Public（公开）
+4. 点击 "Create repository"
+
+## 步骤 2：上传代码到 GitHub
+
+在当前目录打开命令行，执行以下命令：
+
+```bash
+# 初始化 Git 仓库
+git init
+
+# 添加所有文件
+git add .
+
+# 提交
+git commit -m "Initial commit: Python Calculator"
+
+# 添加远程仓库（替换成你的仓库地址）
+git remote add origin https://github.com/你的用户名/python-calculator-android.git
+
+# 推送到 GitHub
+git push -u origin main
+```
+
+如果推送时提示需要设置分支名称，先执行：
+```bash
+git branch -M main
+```
+
+## 步骤 3：等待自动构建
+
+1. 推送成功后，访问你的 GitHub 仓库
+2. 点击顶部的 "Actions" 标签
+3. 你会看到一个正在运行的工作流 "Build Android APK"
+4. 等待构建完成（大约 10-15 分钟）
+
+## 步骤 4：下载 APK
+
+1. 构建完成后，点击该工作流
+2. 在页面底部找到 "Artifacts" 部分
+3. 点击 "calculator-apk" 下载 ZIP 文件
+4. 解压后得到 APK 文件
+
+## 步骤 5：安装到 Android 设备
+
+1. 将 APK 文件传输到 Android 手机
+2. 在手机上打开文件管理器，找到 APK 文件
+3. 点击安装（可能需要允许"未知来源"的应用安装）
+4. 安装完成后即可使用
+
+## 注意事项
+
+- 首次构建可能需要较长时间
+- 如果构建失败，查看 Actions 日志找出原因
+- 每次推送代码都会自动触发构建
+- 也可以在 Actions 页面手动触发构建
+
+## 如果遇到问题
+
+1. 确保所有文件都已正确上传
+2. 检查 `.github/workflows/build.yml` 文件是否存在
+3. 查看 Actions 的构建日志
+4. 确保仓库是 Public（私有仓库可能有限制）