PythonIDE Docs
中文
简体中文

全部模块总览

按分类查看全部 30+ 内置 Python 模块。

主入口iOS 原生能力(入口模型、Python 模块表、AppUI 原生组件入口、专题页与文档导航)。本文是补充索引,按导入名浏览全部模块。

按分类浏览 PythonIDE 内置 Python 模块,快速找到对应能力文档。

边界:这是 模块索引页,不是 import 名。选定模块后打开具体文档;页面型 MiniApp 优先 appui,小组件用 widget

#模块概览

说明
导入表中「导入名」列,如 import photos
适合做什么按任务选运行时与原生模块
页面型 Appappui + 原生模块按钮回调
小组件widget
游戏/绘制scene / turtle

#快速开始

保存设置、读设备、查通知权限:

python
import device
import notification
import storage

storage.set("theme", "system")
print("device", device.model(), device.system_version())
print("theme", storage.get("theme", "system"))

if notification.authorization_status() != "authorized":
    notification.request_permission()

#AppUI 示例

用索引思路组合三个常用模块:设置、设备、通知。

python
import appui
import device
import notification
import storage

state = appui.State(
    theme=storage.get("theme", "system"),
    model="—",
    notify_auth="—",
    message="点击按钮开始",
)


def refresh_all():
    state.model = device.model()
    state.notify_auth = str(notification.authorization_status())
    state.message = "已刷新"


def save_theme():
    storage.set("theme", state.theme)
    state.message = f"已保存主题: {state.theme}"


def request_notify():
    result = notification.request_permission()
    state.notify_auth = str(notification.authorization_status())
    state.message = "已授权" if result.get("granted") else "未授权"


def body():
    return appui.NavigationStack(
        appui.Form([
            appui.Section("设置", [
                appui.Picker(
                    "主题",
                    selection=state.theme,
                    options=["system", "light", "dark"],
                ).picker_style("segmented"),
                appui.Button("保存主题", action=save_theme)
                .button_style("bordered_prominent"),
            ]),
            appui.Section("设备与通知", [
                appui.Button("刷新状态", action=refresh_all),
                appui.Button("申请通知权限", action=request_notify),
                appui.LabeledContent("型号", value=state.model),
                appui.LabeledContent("通知授权", value=state.notify_auth),
                appui.Text(state.message).foreground_color("secondaryLabel"),
            ]),
        ]).navigation_title("模块总览")
    )


appui.run(body, state=state)

#API 参考

#先选运行时

目标首选
工具页、设置页、列表页、媒体控制appui
主屏/锁屏/StandBy 小组件widget
Pythonista 风格命令式 UIui
2D 游戏、物理、逐帧绘制scene
系统能力(照片、定位等)对应原生模块 + AppUI 按钮
纯脚本、日志输出Python + console

#UI 与渲染

模块导入名用途
appuiimport appui声明式原生界面与 MiniApp
aurora_systemimport aurora_system相机、传感器等实时事件
aurora_toolkitimport aurora_toolkit高频更新与批量刷新工具
uiimport uiPythonista 风格 UI
sceneimport scene2D 场景、scene.run、节点、Action、物理与 Classic 绘图
turtleimport turtle原生 turtle 绘图

#设备与传感器

模块导入名用途
deviceimport device设备、屏幕、电池
locationimport location定位、指南针、地理编码
motionimport motion加速度计、陀螺仪、气压计
hapticsimport haptics触觉反馈
biometricimport biometricFace ID / Touch ID
healthimport healthHealthKit 数据

#系统服务

模块导入名用途
permissionimport permission统一权限查询与申请
storageimport storageUserDefaults 键值
databaseimport databaseSQLite 与 JSON collection
keychainimport keychain钥匙串
clipboardimport clipboard剪贴板
consoleimport console弹窗、HUD
dialogsimport dialogs表单与选择器对话框
notificationimport notification本地通知
calendar_eventsimport calendar_events日历与提醒
contactsimport contacts联系人
live_activityimport live_activityLive Activity
nfcimport nfcNFC 读写
alarmimport alarm系统闹钟
mailimport mail邮件撰写
messageimport message短信 / iMessage
translationimport translation设备端翻译
foundation_modelsimport foundation_models端侧文本生成
assistantimport assistant端侧助手与工具
storekitimport storekit内购与订阅
font_pickerimport font_picker字体选择器

#媒体与视觉

模块导入名用途
photosimport photos相册、拍照、保存
camera见 photos拍照(photos.capture_image
file_picker见 appui文件选择(FileImporter
share见 appui分享(ShareLink
avplayerimport avplayer音视频播放
music_playerimport music_player队列式音乐播放器
soundimport sound音效与本地播放器
now_playingimport now_playing锁屏正在播放元数据
audio_recorderimport audio_recorder录音
video_recorderimport video_recorder录像
audio_sessionimport audio_session音频会话
speechimport speech文字转语音
speech_recognitionimport speech_recognition语音识别
shazamimport shazam听歌识曲
musicimport musicApple Music 控制
media_composerimport media_composer音视频合成
pdfimport pdfPDF 创建与预览
qrcodeimport qrcode二维码生成
visionimport visionOCR
vision_helperimport vision_helper人脸、条码、分类
coremlimport coremlCore ML 推理

#网络与数据

模块导入名用途
networkimport networkHTTP、下载
websocketimport websocketWebSocket 客户端
bluetoothimport bluetoothBLE 中心模式
ble_peripheralimport ble_peripheralBLE 外设模式
backgroundimport background后台任务
background_downloadimport background_download后台下载
http_serverimport http_server本地 HTTP 服务
sshimport sshSSH / SFTP
weatherimport weather天气
c_extensions不是 import 名内置 C 扩展清单

#自动化与扩展

模块导入名用途
widgetimport widgetWidgetKit 小组件
shortcutsimport shortcuts快捷指令
objc_utilimport objc_utilObjC Runtime
keyboardimport keyboard编辑器键盘工具栏

#常见错误

错误写法后果修正
不选运行时直接用原生模块堆 UI难维护页面用 appui
import c_extensions模块不存在用真实包名
索引页当 API 文档签名错误点进具体模块页
权限未说明用途就申请被拒率高先展示说明再按钮申请
敏感数据用 storage不安全keychain

#相关文档

文档用途
iOS 原生能力入口模型、模块表与权限矩阵
原生能力入口MiniApp 配方
permission权限
appui声明式 UI

#发布前检查

  • 已选对运行时(AppUI / widget / scene / ui)
  • 模块 API 名与文档一致
  • 权限与失败路径已在示例或正文中说明

#预期效果

运行示例后,界面应出现文档描述的目标结果;若与预期不符,请按「失败路径」排查。